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EDITORIAL 


MACH TECHNOLOGY 


There have been many rumours over 
recent months regarding this company, 
and a good few readers have contacted 
RISC User magazine to see if we had 
any more information. We can now 
report on the latest situation. 


We are advised that Mach Technology is 
seeking voluntary liquidation, and 
accountants J.B.Taylor & Co. have been 
instructed as Advising Accountants. By 
the time you read this it is likely that a first 
meeting of creditors of Mach Technology 
will have been held, and J.B.Taylor & Co. 
appointed as liquidators. 


Anyone who is owed money by Mach 
Technology should therefore write to 
J.B. Taylor & Co. at 8 High Street, Yarm, 
Stockton, Cleveland giving full details of 
their claim (if they have not already done 
so). 


For reference, J.B.Taylor's phone number 
is (0642) 790790, but readers are 
advised to communicate in writing in the 
first instance. 


BEEBUG SUMMER COMPETITION 


We are now able to bring you the results of 
our summer competition announced in the 
July/August issue of RISC User. The first 
prize of an A3000 colour system, 
generously provided by Acorn, was won by 
Paul Warren of Bridgwater in Somerset 
who used a BBC model B. A number of 
other companies including Clares Micro 
Supplies, Colton Software, Computer 
Concepts and Minerva Software donated 
prizes for the runners up, and these are 
shared by Dr.R.Murphy (BBC model B), 
Mr.P.Dodgshon (model B), Mrs.A.Miskin 
(Master) and Mr.G.Hopkins (model B). 





We hope to publish more details of the 
winning entries in due course, but it is 
interesting to note that although an equal 
number of entries was received from both 
BEEBUG and RISC User members, only 
four Archimedes owners reached the final 
short-list of twenty. 


MISCELLANEOUS 


The original binders introduced for RISC 
User have eventually proved to be too 
small to hold a complete set of volume 2 
due to the ever increasing size of the 
magazine - a record 72 pages this month. 
We have therefore obtained supplies of 
new binders, identical in format to the 
original, but capable of holding a full ten 
copies of current issues. We expect these 
to be entirely adequate to cope with the 
whole of volume 3. At present we still 
have some stocks left of the original size 
of binder which is ideal for holding 
volume 1. 


We currently have three RISC User offers 
of discs; the updated ArcScan || with all 
the references not only to BEEBUG and 
RISC User but also to all of Acorn's 
manuals for the Archimedes including 
both old and new Programmer's 
Reference Manuals; the popular RISC 
User Toolbox which is still available; and 
our more recently announced Movie 
Maker disc offering excellent value for 
money at just £4.75. Full details on all of 
these products are provided elsewhere in 
this issue. 


Last, but not least, our season's greetings 
to you and our best wishes for 1990. 
Remember that the next issue of RISC 
User will cover both January and 
February, and should be distributed late 
January. 


o News - News 


NEW RELEASE OF 1ST WORD PLUS 


Acorn was set to release a new version of its 1st 
Word Plus word processing package on 1st 
December. The new release is very much in 
the style and flavour of the original 
Archimedes version, reflecting its history of 
development on other micros. However, the 
new version is now fully multi-tasking, and 
uses all the standard RISC OS features such 
as dragging. 


The spelling dictionary has been substantially 
increased in size and now boasts some 70,000 
words. Another, though smaller feature that 
many will welcome is a swap case function, 
missing from 1st Word Plus until now. This 
not only swaps the case of a letter, but also 


has options to force a letter to lower case, to |E 


upper case, or to title style, where the initial 
letter of any word is put into upper case. 


Acorn says that the opportunity has been taken 
to effect other minor improvements, but that the 
main enhancement is to a full Riscware product. 
The new version remains at the same price of 
£91.94 inc, VAT. Existing users will be able to 
upgrade to the new version for £44.85 (inc. VAT), 
but the arrangements for this were not known 
other than that upgrades will not be handled 
directly by Acorn (a similar procedure to 
upgrades to release 3 of C). Perhaps we can also 
expect Acorn to take a fresh look at Logistix, 
and maybe Acorn DTP as well, and respond to 
the increasing demands of users. 


Acorn Computers is at Cambridge Technopark, 
645 Newmarket Road, Cambridge CB5 8PD, 
tel. (0223) 214411 (*). 


JUST JIGGLE IT A BIT 


One of the most appealing products for some 
while has just landed on the RISC User editorial 
desk from educational software company 
4mation. The new program, which is the 
company’s first for the Archimedes, is called 
Jigsaw, and that is just what it is. The graphics 
and presentation are simply superb. Fifteen 
stunning graphics pictures are supplied as part 
of the two-dise pack, but any saved screen or 
sprite may be used. 


The software breaks the picture up into jigsaw 
shaped pieces which you then have to fit 
together using the mouse for control. Difficulty 
can also be varied by choosing how many pieces 
each puzzle should have (from 12 to 120). 





e News - News » 





Claimed as suitable for all ages, Jigsaw costs 
£33.35 inc. VAT from 4mation Educational 
Resources, Linden Lea, Rock Park, Barnstaple, 
Devon EX32 9AQ, tel. (0271) 45566. 


BEEBUG SUPPORTS THE A3000 

The development side of BEEBUG has been 
busy working on two major hardware releases 
for the new A3000. The first of these is an 
internal modem which supports speeds right up 
to V22bis (2400 baud), The modem is fully 
Hayes compatible, and features both auto- 
answer and auto-dial (both tone and pulse 
dialling), A version of BEEBUG’s highly 
acclaimed Hearsay comms package will be 
supplied with the modem. The price has yet to 
be finalised, but it is expected to be very 
competitive. The A3000 modem will be available 
during the first quarter of 1990, 


The second new product is a dise drive buffer 
with a difference. This will allow the connection 
of up to four external floppy drives, and offers 
features such as the ability to double step drives 
for use with the PC Emulator. The ‘difference’ is 
that with the addition of a user-fittable upgrade, 
the unit can be expanded to a full SCSI 
interface, allowing the connection of external 
hard disc drives and other peripherals which use 
this industry-standard interface. Again the price 
is to be finalised with a release date in early 
1990 (*). 


GENESIS - A MULTI-MEDIA DATABASE 


Software Solutions has announced the launch of 
its latest software product, Genesis, to be 
unveiled at the BETT’90 show at the Barbican 
in January. Genesis provides a framework for 
creating pages of linked information consisting 
of text, graphics, sound and animation. Software 
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Solutions claims that Genesis, designed in 
collaboration with the Hampshire LEA, will 
address many of the issues raised by the 
National Curriculum in schools. Genesis is 
available at £80.42 (inc. VAT) from Software 
Solutions, Broadway House, 149-151 St 
Neots Road, Hardwick, Cambridge CB3 7QJ, 
tel. (0954) 211760. 


THROUGH THE ARCHED WINDOW 


Latest news from Simtron, producers of the 
Archway package for creating and 
manipulating windows, is that the projected 
version 1.1 has now been dropped in favour of a 
full Riscware version 1.2 which is expected to 
be completed very soon. Until then, the existing 
version of Archway, which is already RISC OS 
compatible, will continue at just £79.95 inc. 
VAT. The new V1.2 release will be priced at 
£99.95 (ine. VAT), but existing users of the 
product will be able to upgrade entirely free of 
charge. Further details are available from 
Simtron, 4 Clarence Drive, East Grinstead, 
West Sussex RH19 4RZ, tel. (0342) 328188. 


ARTISAN SECOND EDITION 


Clares has now released Artisan 2, a completely 
updated and RISC OS version of its top selling 
art package Artisan. As befits a product that 
sells well to schools, Artisan 2 has a number of 
added features which benefit teachers and 
others. Menus now ‘stick’ to the screen until the 
user commences a new operation, and the range 
of features can be restricted so that children can 
only use those parts of the package with which 
they are familiar. The area of pattern 
generation has been substantially improved, 
and the package is now capable of producing 
colour separations, ideal for subsequent 
printing. 


Artisan 2 costs just £59.95, but existing users 
can upgrade by returning their original disc and 
a cheque for £30. Clares has also dropped the 
price of Pro-Artisan to £99.95 (ine. VAT) which 
brings it into line with Minerva’s Atelier. Clares 
Micro Supplies are at 98 Middlewich Road, 
Rudeheath, Northwich, Cheshire CW9 7DA, 
tel. (0606) 48511 (*). 


REVISED C FRONT 


Mitre Software has announced release 2 of its 
C-Front package incorporating support for 
release 3 of Acorn’s ANSI C compiler (see review 
in this issue). C-Front includes an easy-to-use 
‘front end’ for the compiler allowing the user to 
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choose all the compiler options he requires and 
then to compile the file by simply dragging it to 
the application. 


C-Front costs just £19.95 (inc. VAT and p&p), 
while users of release 1 may upgrade free of 
charge by returning their original release 1 to 
Mitre. Mitre Software is at International House, 
26 Creechurch lane, London EC3 5BA, tel. 01- 
283 5614. 


EUCLID SEE THE LIGHT 


Ace computing, well known for its best selling 
3D graphics package Euclid, has announced two 
new products for users of Euclid, ArcLight, a ray 
tracing package and a disc containing 
applications, library pictures and other 
material, from Elements, the independent 
Euclid user group. 


Elements is based on an annual subscription of 
£10 for which the user will receive four 
Elements discs, one per quarter. These will be 
available from Richard Molyneux, Elements, 42 
Keswick Road, Great Bookham, Leatherhead, 
Surrey KT23 4BH (but cheques should still be 
made payable to Ace Computing). 


ArcLight is expected to be available at the end 
of the year, but as yet no price has been 
announced. You can contact Ace Computing at 
27 Victoria Road, Cambridge CB4 3BW, 
tel. (0223) 322559 (*). 


DIGIT CHANGES HANDS 


Software for image analysis, originally 
marketed by the Institute of Opthalmology, is 
now available from B.P.Hayes Software, 31 
Priory Gardens, Berkhamsted, Herts HP4 2DS, 
tel. (0442) 872092. The software is called Digit, 
and costs £150 inclusive. 


BETT 1990 


The next British Education and Training 
technology show (BETT 1990) takes place at 
the Barbican Centre from 17th to 20th 
January 1990. This provides a showcase for all 
technology based products (including 
computers from Acorn and others) aimed at all 
involved in education and training. For more 
information, contact EMAP International 
Exhibitions Ltd., 12 Bedford Row, London 
WCI1R 4DU, tel. 01-404 4844. 


NOTE: Products marked (*) are stocked by 
BEEBUG - see Retail Catalogue. RU 
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Tine RISC USER Areh 
Toolbox 


A Powerful Utility for the ARCHIMEDES offering: 


Memory Search - a full screen editor which 
enables you to find a sequence of bytes, words 
or characters quickly and easily. 

Memory Editor- with the help of this you can 
examine and alter memory in either hex or 


ASCII mode. 

Disc Sector Editor- a most helpful command for 
examining and changing disc contents directly. 
Ideal for repairing corrupted discs and recovering 
lost files. 

Dissasembler- this command displays the contents 
of memory as ARM instructions including floating 

point and co-processor mnemonics. 

Plus many other powerful commands including: 

* File Find e File Compare * Catall 
° File Go To ° Exall * Memory Dump 


AOR TOCSSLER 


The full Screen Disc Sector Editor 





Archimedes Movie Maker 






FRAME: 11 (13) FREE: 592K 25332 [| A Full-feature Application for Creating Cartoons 
and Animated Sequences: 


Fully mouse controlled 
* Sprite import-export 

* Variable frame rate 
Multi-size brush 

256 colour palette 


TT TTEN e senet 
<e P Replay Brush 2 and many other features 
Clea’ Frs 25 


. 


. 


























— pe, ee ee, ee eee Remengenety: = a a E a E 1 
i Archimedes TOOLBOX disc and documentation Code 1401A members' price of 673 U i 
i non-members' price of £15.00 mj l 
{ Movie Maker disc and documentation Code 1410A members' price of s73 DO i 
| non-members’ price of £15.00 O} 
i Name i 
| Address. Price £ | 
i Postage (60p per item) £ 1 
i Memership No. Total £ ! 
i i 
1 I enclose a cheque for £. OR please debit my Access, Visa or Connect account, Card i 
1 No / / / Expiry / Signed. i 
i | 
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How many times have you wanted to 
create a RISC OS application, either for a 
program typed in from a listing, or for one 
you are developing, and found yourself 
without a suitable sprite? The short 
accompanying utility will solve the 
problem, and even generate a suitable 
accompanying !Run Obey file. 


The program allows you to create 
applications icons consisting of 
up to eight characters of text 
against a bordered background. The text 
is freely entered from the keyboard, and 
the mouse is used to select colours from 
the Wimp’s standard palette for the text, 
background and border of the sprite. The 
utility will also create a suitable 
application directory and a generalised 
!Run obey file if required, and save the 
sprite under the correct name. Once you 
have run the program, you can enter the 
Desktop, and immediately see your new 
application with its own icon on | 
display. 


RUNNING THE PROGRAM 

First type in the program and save 
it to disc. Before using it you will need 
to make a palette file containing the 
standard Wimp palette. To do this, 
enter the Desktop, press Menu over 
the palette icon (to the left of the A 
icon on the icon bar), slide the pointer 
across the “Save” icon, and enter the 
name “DeskPal”, then drag the icon to 
the directory viewer in which you 
have saved the sprite generator 
utility. 





rit 


The 


Now leave the Desktop (Ctrl-Shift- 
F12), get into Basic again (*BASIC), and 
run the Application Generator. You will be 
asked for the name of the application 
with which the sprite is to be used (e.g. 
$.UTILS.!MyApp). Note that application 
names must begin with a “!”, and that you 
should give the full path back to the root 





An Application Shell Generator 


by Lee Calcraft l 


directory ($). The name you enter is 
important because the sprite’s name will 
be derived from it, and the sprite will be 
saved to this directory at the end of the 
program. You will then be asked whether 
this directory needs to be created. If you 
answer “Y”, then if it does not already 
exist, one will be created. Next you will be 
asked if you require a !Run Obey file, and 
if you answer “Y”, you will be asked for 
the expected size of the accompanying 
application program. Enter its size in 
Kbytes, or press Return for a 32K default. 


Instructions will now appear on screen 
telling you how to define the sprite. 
Essentially, you enter up to eight 
characters (including spaces if required). 
You can use the Delete key to correct 
errors (but not the cursor keys), and to 
move down to the second line, you should 
use the space bar, since Return is used as 
a signal that the sprite is complete. 


APPLICATION SPRITE GENERATOR 


Wipe shee Pe sree vit 


a LA 


Lite up to iat tt Hay tite i 
tb save the sprite 


T e 


Select =text 
zbat 
just 


e named as IA; 


‘ite file saved Hea $ Tfpptaker as {Sprites 


Sprite Generator is largely self-documenting 


At any time during the process, you 
can pick up text, background or border 
colours from the accompanying palette by 
using the Select, Menu or Adjust buttons 
of the mouse respectively. When all is 
complete, just press Return, and the 
sprite will be saved to the appropriate 
directory. You can verify this by getting 
back to the Desktop. You should see the 
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An Application Shell Generator 


new sprite on display as the icon for its 
application. Of course, if you wish to 
embellish your sprite, you can always 
load it into Paint, and adjust it pixel by 


pixel. 


RUNNING IT FROM THE DESKTOP 

This utility may prove to be even more 
useful if it is directly runnable from the 
Desktop. You can easily achieve this using 
the utility itself. Run the program, and 
enter “Y” for a new directory, and supply 
the name “$.!AppMaker”, request an Obey 
file, and press Return for a 32K default. 
Now design a sprite using the utility, and 


the job is almost done. 


All you need to do now is to alter line 


110 of the program to: 
*PRINT <AppMaker$Dir>.DeskPal 


and save it with the name “!RunImage” in 
the new directory $.!AppMaker. Then copy 
the palette file DeskPal into this directory, 


and the job is done. 


Note: This month’s magazine disc 
contains a version of this program which 


runs from the Desktop. 


10 REM >AppGen4d 

20 REM Program Applic Generator 
30 REM Version A 0.04 

40 REM Author Lee Calcraft 

50 REM RISC User December 1989 


80 o%=0 

90 ON ERROR PROCerror:END 
100 MODE12 

110 *PRINT DeskPal 

120 PROCpalette 

130 PROCinitial 

140 PROCdraw 

150 REPEAT 

160 REPEAT 

170 A=INKEY (0) 

180 MOUSE x,y,Z 
190 UNTIL A>-1 OR 2>0 


200 IF z>0 THEN PROCmouse ELSE PROCt 


60 REM Program Subject to Copyright 


210 UNTIL A=13 

220 PROCsavesprite 

230 END 

240 : 

250 DEFPROCinitial 

260 DIM sp &400:!sp=6400 

270 sp!4=0:sp!8=16:sp!12=16 

280 COLOUR 129:COLOUR 8 

290 PRINT TAB(26,3) "APPLICATION SHELL 
GENERATOR" 

300 PRINT TAB(2,6)"Wimp palette is set 
. Directory viewers" 

310 PRINT " and icon bar background a 
re colour 1." 


320 PRINT '" Enter application name i 
nc path." 

330 PRINT " For example :0.$.UTILS.!A 
pplic" 


340 INPUT " Name: “,name$ 

350 PROCgetappname 

360 PRINT " Does this need to be crea 
ted Y/N? "; 

370 AS=CHR$ (GET AND &DF) :PRINTAS 

380 IF AS="Y" THEN OSCLI ("CDIR "+name$) 

390 PRINT " Generate !Run Obey file Y 
m"; 

400 AS=CHR$ (GET AND &DF) :PRINTA$ 

410 IF A$="Y" THEN PROCobeyfile 

420 PRINT '" Now enter up to 8 letter 
s into the box," 

430 PRINT " using the mouse to pick n 
ew colours." 

440 PRINT " Then press Return to save 
the sprite." 

450 PRINT TAB (5,25) "Select =text" 

460 PRINT TAB (5,26) "Menu =background" 

470 PRINT TAB (5,27) "Adjust =border" 

480 *POINTER 

490 bgc=8:fgc=9:bor=15 

500 string$="" 

510 VDU28, 12, 21,15,20 

520 ENDPROC 

530 : 

540 DEFPROCobeyfile 

550 INPUT" Program size in K (Ret=32K 
)? "size$ 

560 IF size$="" THEN size$="32" 

570 K$=RIGHT$ (size$) 

580 IFK$="K" OR K$="k" THEN size$=LEFT 
$(size$, LEN (size$)-1) 


RISC User December 1989 


An Application Shell Generator 


590 len=LEN (appname$) 

600 o%=OPENOUT (name$+". !Run") 

610 BPUT# o%,"| !Run Obey file for "+a 
ppname$ 

620 BPUT# o%,"WimpSlot -min "+size$+"K 
-max "+size$+"K" 

630 BPUT# 0%,"Set "+RIGHTS (appname$, le 
n-1)+"$Dir "+CHR$60+"Obey$Dir>" 

640 BPUT# 0%,"Run "+CHRS60+RIGHTS (appn 
ame$, len-1)+"$Dir>.!RunImage %*0" 

650 CLOSE #0%:0%=0 

660 OSCLI("SetType "+name$+".!Run Obey") 

670 ENDPROC 

680 : 

690 DEFPROCmouse 

700 colour=POINT (x,y) 

710 CASE z OF 

720 WHEN 4 :fgc=colour 

730 WHEN 2 ;bgc=colour 

740 WHEN 1 :bor=colour 

750 ENDCASE 

760 PROCdraw 

710 REPEAT 

780 MOUSE x,y,z 

790 UNTIL z=0 

800 ENDPROC 

810 : 

820 DEFPROCdraw 

830 GCOL bgc 

840 RECTANGLE FILL 188,316, 68, 68 

850 GCOL bor 

860 RECTANGLE 188, 316,68, 68 

870 COLOUR fgc:COLOUR 128+bgc 

880 VDU30 

890 len=LEN (string$) 

900 PRINTstring$; 

910 IF len=4 THEN VDU10,13 

920 ENDPROC 

930 : 

940 DEFPROCtext 

950 len=LEN (string$) 

960 CASE TRUE OF 

970 WHEN A>31 AND A<127:IF len<8 THE 
N VDU A:string$+=CHRSA:IF len=3 THEN VDU 
10,13 

980 WHEN A=127 

990 IF len<>0 THEN 





9,9,9, 9:string$=LEFTS (string$,len-1) 
1020 ELSE VDU7 

1030 ENDIF 

1040 ENDCASE 

1050 ENDPROC 

1060 : 

1070 DEFPROCpalette 

1080 GCOL 129:CLG 

1090 VDUS 

1100 FOR A=0 TO 15 

1110 MOVE 600,724- (A*40) 

1120 GCOL 7:PRINT A:GCOL A 

1130 RECTANGLE FILL 800, 700-(A*40),100, 
30 

1140 NEXT 

1150 VDU4 

1160 ENDPROC 

1170 : 

1180 DEFPROCsavesprite 

1190 savename$=name$+".!Sprites" 

1200 MOVE 188,316:MOVE BY 68,68 

1210 SYS "OS _SpriteOp",270, sp, appname$, 1 
1220 SYS "OS _SpriteOp", 268, sp, savename$ 
1230 VDU 26:COLOUR 129:COLOUR 8 

1240 PRINT TAB(0,29)"Sprite named as "a 
ppname$ 

1250 PRINT "Sprite file saved in "name$ 
7" as !Sprites" 

1260 ENDPROC 

1270 : 

1280 DEFPROCgetappname 

1290 appname$=name$ 

1300 REPEAT 

1310 B%=INSTR(appname$,".") 

1320 IF B%>0 THEN 

1330 len=LEN (appname$) 

1340 appname$=RIGHTS (name$, len-B%) 
1350 ENDIF 

1360 UNTIL B%<=0 

1370 ENDPROC 

1380 : 

1390 DEFPROCerror 

1400 ON ERROR OFF 

1410 VDU26, 4 

1420 COLOUR 7:COLOUR 128 

1430 PRINT TAB (0,28)REPORT$" at line "; 
ERL 





1000 IF len<>5 THEN VDU127:string 1440 IF 0%>0 THEN CLOSE# 0% 

$=LEFTS (string$, len-1) 1450 ENDPROC 

1010 IF len=5 THEN VDU127:VDU11, AW 
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INVESTIGATOR 1.02 a, 


£24.95 





THE SERIAL PORT 








Investigator is a disc utility program which is compatible = 
with the Archimedes 300, 400 and 3000 series using 
either the Risc OS or Arthur 1.2 operating systems. k 
Investigator can perform the following operations on discs 
of many different formats: 














è Examine the format of the disc in detail. 
e Edit the data stored on the disc. 
© Make backup copies of the disc. 


© Store the entire disc as an ordinary ADFS file. This 
may allow archives of several master discs to be stored 
ona single backup disc. The disc may then be 
transmitted to a remote site using a modem and a 
communications package such as ARCterm. 


è Fully WIMP front end. 


The Serial Port, Burcott Manor, Nr Wells, Somerset BA5 INH 
Voice (0749) 72234 Data (0749) 79794 (300-2400 baud) 





Please send me [ ] INVESTIGATOR 1.02 at £24.95, cheque, PO enclosed. 
Data Sheet 

















Name 
Address 























CJE MICROS 


WATFORD ELECTRONICS 





Memory Upgrades for the A3000 and A300 


Mike Williams reports 


R ecent software releases (Acorn DTP 
for example), and rumours about the next 
release of RISC OS have begun to make 
1MByte of memory seem quite meagre. 
Owners of 400/1 series machines can, of 
course, upgrade their machines to a full 
4MBytes, but what of A3000 and A300 
owners? 


Those with an A3000 can upgrade 
their machine quite easily from 1MByte to 
2MBytes with the standard Acorn 
upgrade, and the A3000 has the merit 
that it has been designed to be upgraded 
in this way, making the enhancement both 
easier to design and fit. Other suppliers 
are now beginning to offer alternative 
2MByte upgrades for the A3000, and also 
upgrades to 4MBytes. 










A3000 2MByte upgrade £172.00 
A310 2MByte Upgrade £380.00 
A310 4MByte Upgrade £600.00 











A3000 2MByte Upgrade £182.85 
A3000 4MByte Upgrade £516.35 
A310 2MByte Upgrade £373.75 
A310 4MByte Upgrade £631.35 
COMPUTERWARE 
A3000 2MByte Upgrade £159.85 
A3000 4MByte Upgrade T.B.A. 
A310 2MByte Upgrade £399.00 
A310 4MByte Upgrade £699.00 
MORLEY ELECTRONICS 
A3000 2MByte Upgrade £172.50 
A3000 4MByte Upgrade £477.25 


All prices include VAT. Memory sizes refer to the total 
memory after upgrade. 






Memory upgrades for the A3000 and A310 


Those at the gravest disadvantage are 
owners of A305 and A310 machines. As 
these systems were never designed to be 
upgraded beyond 1MByte, the task of 
designing and fitting such an 
improvement is that much harder for the 


supplier. To date we are aware of four 
companies who are developing products in 
this field, and the details are summarised. 
in table 1. 


So far, CJE Micros has been able to 
supply a review sample, but Watford 
Electronics, which claims that it is 
satisfying customer’s orders, has been 
unable to supply a sample for review, 
despite repeated requests. Computerware 
and Morley Electronics are still working 
on completing prototypes. 


CJE MICROS’ TWO AND FOUR 
MEG UPGRADES 

CJE Micros is currently offering 
upgrades to both 2MBytes and 4MBytes 
for the A310. The price includes the 
upgrade, fitting by CJE Micros, and 
collection and return of the customer’s 
machine, which should guarantee that the 
upgrade is properly fitted and tested. 


The new memory board is fitted just 
above the existing banks of memory at the 
front of the machine, and underneath any 
internally fitted disc drives. Thus there is 
very little obviously different once the 
upgrade has been completed. 


When CJE fits the upgrade, alternate 
memory chips are removed (by 
unsoldering) from the original board, and 
sockets fitted in their place into which the 
new 1board is then plugged. The old and 
additional memory fits on the new board. 
There is also a flying lead connecting the 
new board to the additional address line of 
MEMC necessary to expand the memory 
beyond the standard 1MByte. Each 
additional 1MByte of memory is provided 
by eight standard memory chips 256K by 
4bits. The general standard of work 
appears to be entirely satisfactory, though 
by no means simple to effect. 


As far as the user is concerned, he 
simply receives back a machine which 
when switched on now has 2Mbytes (as in 
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our review machine), or 4MBytes of 
memory. This can be checked by invoking 
the Task Manager. No other problems 
were encountered in use. 


COMMENTS 

The CJE upgrade involves component 
level work on your Archimedes, which 
means unsoldering and resoldering 
components as required. The upgrades 
offered by other companies are said to be 
solderless, but Computerware and Morley 
Electronics (at least) still recommend 
dealer fitting. 


CJE’s prices are highly competitive 
despite including carriage both ways and 
fitting. The 2MByte upgrade can also be 
expanded to 4MBytes by adding the 
additional chips to the same board - CJE 
says its charge for this will be 
approximately £250, 


There is however the question of what 
may happen if your machine should 
subsequently develop any fault and need 








SOLOMON SOFTWARE 


O DISK. Just send a blank disk and 
demonstration version of the 
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“HOT-PURSUIT? — £14.95 
s CHEQUES PAYABLE 
Solomon Software, 

PO Box 258 
Wolverhampton WV2 3AS 

Tel: (0902) 28522 
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repair. It is also unclear how the warranty 
is affected, if the upgrade is fitted while 
this is still valid. CJE says it is aware of 
these possible problems but will ensure 
customers are not abandoned. 


Apart from the considerations above, 
CJE appears to have done an excellent job 
at a price which may well prove tempting. 


NOTE: BEEBUG is currently stocking the 
memory upgrades produced by 
Computerware (see Retail Catalogue), but 
other suppliers are under consideration. 


Addresses: 
CJE Micros, 78 Brighton Road, Worthing, 
West Sussex BN11 2EN, tel. (0903) 213361. 


Computerware, 11 Livestock Market, Hall Road, 
Norwich NR4 6DW, tel. (0603) 507799. 


Morley Electronics, Morley House, 
Off Norham Road, North Shields, Tyne & Wear 
NE29 7TY, tel. 091-257 6355. 


Watford Electronics, Jessa House, 
250 Lower High Street, Watford WD1 2AN, 
tel. (0923) 37774. RU 


A BIGGER, B 
for the Ar 


ER DIARY 
imedes 


Choice of three diary sizes. 

|| You can have several active diaries and choose the 
sizes, up to 15 lines of 40 characters, to suit the task, 
with more than one year for each task. Easy to use with 
on-line HELP. The program is fully WIMP based, and 
muttitasks with RISC-OS. 


‘See a full year at a glance. 

A single window shows part of the entry for every day of 
the year. See the free days or spot that elusive entry at a 
glance. A string search facility enables lost entries to be 
found. 


Instant viewing of the full entry for any day. H 
Skim the mouse over the year to scan the full entries for |} 
any day and just 'click' on a day to make an entry. To-day's 
entry can be kept on screen for reference. 


Print all of a month with Just one command. 

Select the month, or months, to be printed. Then choose 
from either a full page formatted print-out, or a quick 
single line per day, showing only those days which have 
an entry. 


£14.95 
(incl. VAT & U.K.p&p) 
Official Orders also welcome. 
QUERCUS COMPUTER SYSTEMS 
Courtyard House, North Otterington 
Northallerton, N. Yorks, DL7 QEP 


Cheque or P.O. to 


(tel. 0609 70643) 





RISC User December 1989 


A Desktop Calculator 


by Mike Ironmonger 


T he program listed with this article 
provides a powerful but easy-to-use RISC 
OS Desktop calculator. It offers major 
improvements over the calculator supplied 
with RISC OS by Acorn, which is less than 
adequate for many purposes. The program 
runs from an application directory and 
displays its own icon on the icon bar. 
Clicking on that icon invokes the 
calculator. 


The first thing 
you'll notice 
about the 
calculator is 
that there are 
three numeric 
displays. These 
can be used 
quite freely, 
either to per- 
form calcula- 
tions or to store 
an expression 
or number. 
They are in fact 
writeable icons, 
each with a buffer of 256 bytes, and they 
accept full expressions entered via the 
keyboard and/or the calculator buttons. 
This means that you can use any of 
Basic’s arithmetic functions, so that 
things like SIN(PI) and LOG(99) are quite 
acceptable. The ‘E’ key can also be used to 
enter floating point numbers in the same 
kind of format as used by Basic (e.g. 
13.34E-2), 


snes.) 
BO ee 
aS 





Using the calculator to 
evaluate expressions 


Any of the three displays can be 
selected by moving the mouse pointer to 
the required display and pressing Select. 
The current display line will always be 
the one showing the red caret. To 
evaluate an expression, just enter the full 
expression into any of the displays, 
selected with the pointer, and then press 
Select on one of the icons out of Hex, 
Binary, or Decimal depending upon the 
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format in which you want to see the 
result. Alternatively, press the Return 
key, and the result will be displayed in 
the format last selected by the mouse (or 
decimal by default). If there’s an error in 
the expression (e.g. a missing bracket), or 
the calculation produces an error (e.g. 
division by zero), then the error is 
reported in the normal way and the 
expression is left intact. 


As well as obtaining results in 
hexadecimal and binary (if required), 
numbers can also be entered in either of 
these formats if preceded by a ‘&’ or ‘%’ as 
appropriate, but this symbol must be 
entered from the keyboard. The calculator 
thus provides a convenient way of 
converting numbers between the three 
number systems. 


To the right of the three displays are 
three ‘C’ icons which can be used to clear 
the corresponding display. To the left of 
the displays are three red recall icons 
‘Fl’, ‘F2’, and ‘F3’. Clicking on one of 
these, or pressing function key F1, F2, or 
F3, will insert the contents of the 
appropriate display at the current caret 
position. 


INSTALLING THE PROGRAM 

You will first need to create an 
applications directory on your dise with 
the name !Calc. We shall use the same 
icons as used by the Acorn RISC OS 
calculator, To do this, double-click on 
your new !Calc directory while holding 
down Shift, to open its application 
directory. Then click to display the 
directory viewer for Applications Disc 
2, and repeat the process (Shift-Double- 
Click) on the application directory 
there called !Calc. Now drag the file 
called !Sprites from the application 
directory for the Acorn disc, to the 
corresponding application directory of 
your own disc. 
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You will also need to type in the 
program listed here and save that also in 
the !Cale applications directory of your 
disc with the name !RunImage. While you 
are debugging this change line 80 to: 

80 ON ERROR VDU4:PRINT REPORTS;” at li 
ne “;ERL:END 


to trap any errors arising from mis- 
typings. Change this back to the original 
format when you are confident the 
program is working correctly. 


Finally, you 
will also need to 
create and save 
a !Run file in 
your new appli- 
cation directory. 
This is most 
easily achieved 
by installing 
Edit from Appli- 
cations Disc 1, 
and then (using 
the Menu button) 
select Create and 
then New Obey 
file from the menu options. Enter Listing 1 
(the first two lines are optional), and then 
save the Obey file in your !Cale 
applications directory with the name !Run. 


Number conversions 


If you close the application directory, you 
should then find that you can install and 
use your new calculator as already 
described. 


Listing 1 

| !Run file for !Calc 

| Mike Ironmonger 
WimpSlot -min 16K -max 16K 
Run <Obey$Dir>. !RunImage 


Listing 2 
10 REM 
20 REM Program 
30 REM Version A 2.00 
40 REM Author Mike Ironmonger 
50 REM RISC User December 1989 
60 REM Program Subject To Copyright 
10: 


>$.!Calc. !RunImage 
RISC 0S Calculator 





80 ON ERROR PROCerror (ERR, REPORTS) :GO 
TO 110 

90 PROCinitialise 

100 : 

110 REPEAT 

120 SYS "Wimp Poll", &33,block% TO A% 

130 CASE A% OF 


140 WHEN 2 : SYS "Wimp OpenWindow",, bl 
ock% $ 

150 WHEN 3 : SYS "Wimp_CloseWindow", ,b 
lock’ 

160 WHEN 6 : PROCbutton_click (block%!8 


,block$!12,block!16) 

170 WHEN 8 : PROCkey press (block$!4,bl 
ock%!8, block’ !24) 

180 WHEN 9 : quit%=(!block%=0) 

190 WHEN 17,18 : quit%=(block%!16=0) 

200 ENDCASE 

210 UNTIL quit’ 

220 SYS "Wimp_CloseDown" 

230 END 

240 : 

250 DEF PROCbutton_click (B%, W%, 1%) 

260 CASE B% OF 

270 WHEN 1,4 : PROCsa_click(W%,1%) 

280 WHEN 2 : IF We=-2 PROCquit_menu(!b 
lock$) 

290 ENDCASE 

300 ENDPROC 

310 : 

320 DEF PROCkey_press (D%, X%,C%) 

330 CASE C% OF 

340 WHEN 13 : PROCeval (ret%,D%) 

350 WHEN &181,&182,4183 : PROC£_key((C 
$-G181) *3, D%) 

360 WHEN &18E : 
$+3,X%,-1) 

370 WHEN &18F 
$-3,X%,-1) 

380 OTHERWISE SYS "Wimp _ProcessKey",C% 

390 ENDCASE 

400 ENDPROC 

410: 

420 DEF PROCsa_click (W%,1%) 

430 SYS "Wimp GetCaretPosition", , block 


IF D%<7 PROCcaret_to(D 


: IF D%>1 PROCcaret_to(D 


oe 


440 IF !block%=w_calc% D%=block$!4 ELS 
E D%=9 

450 CASE W% OF 

460 WHEN w_calc% 
D$) 


: PROCcalc_button (1%, 
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470 WHEN -2 : PROCopen window (w_calc%) 
:IF D%=9 PROCcaret_to(1,999,-1) 
480 ENDCASE 
490 ENDPROC 
500 : 
510 DEF PROCcale_button (1%, D4) 
520 CASE I% OF 
530 WHEN 2,5,8 : PROCdisplay("",1%-1,D 
$<>1%-1) 
540 OTHERWISE IF D%<9 CASE I% OF 
550 WHEN 0,3,6 : PROCf£_key(I%,D%) 
560 WHEN 20,25,30 : PROCeval (I%,D%) 
570 OTHERWISE 
580 !block%=w_calc%:block$! 4=1% 
590 SYS "Wimp GetIconState", ,block% 
600 SYS "Wimp ProcessKey", block%?28 
610 ENDCASE 
620 ENDCASE 
630 ENDPROC 
640 : 
650 DEF PROC£_key (K%,D%) 
660 I%=block%!20 
670 B$=FNstring (K%) :C$=FNstring (D%) 
680 AS=LEFTS$ (C$, I$) +B$+MID$ (C$, 1%+1) 
690 PROCdisplay (A$,D%, I$) 
700 ENDPROC 
710: 
720 DEF PROCeval (1%,D%) 
730 ret%=1% 
740 AS=FNstring (D%) 
750 V=0:IF A$<>"" V=EVAL (AS) 
760 CASE I% OF 
770 WHEN 20 : 
%,0) 
780 WHEN 25 ; 
,D%,0) 
790 WHEN 30 : 
800 ENDCASE 
810 ENDPROC 
820 : 
830 DEF PROCdisplay (A$, D%, I%$) 
840 Sexp% (D¢DIV3) =A$ 
850 IF I%=0 I%=LEN (A$) 
860 IF I%>=0 PROCcaret_to(D%,X%, 1%) 
870 PROCset_icon_state(w_calc%,D%,0,0) 
880 ENDPROC 
890 : 
900 DEF FNbin (V%) 
910 AS="" 
920 REPEAT 
930 AS=CHRS (48+ (VAND1) ) +AS 


PROCdisplay ("&"+STRS~V,D 
PROCdisplay ("$"+FNbin (V) 


PROCdi splay (STRS$V,D%, 0) 
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940 V2=VE>>>1 
950 UNTIL V%=0 
960 =A$ 
970 : 
980 DEF FNstring (D%) 
990 AS="";P%=exp% (DSDIV3) 
1000 WHILE ?P%>31 
1010 A$+=CHRS$?P%:P%+=1 
1020 ENDWHILE 
1030 =A$ 
1040 : 
1050 DEF PROCset_icon_state(!block%, blo 
ck%!4,block%!8, block%!12) 
1060 SYS "Wimp SetIconState", , block’ 
1070 ENDPROC 
1080 : 
1090 DEF PROCcaret_to(D%,X%,1%) 
1100 SYS "Wimp SetCaretPosition",w_calc 
%,D%,X%,0,-1,1% 
1110 ENDPROC 
1120: 
1130 DEF PROCerror (!block%, $ (block%+4) ) 
1140 SYS "Wimp_ReportError",block%,1,"C 
alculator" 
1150 ENDPROC 
1160 : 
1170 DEF PROCinitialise 
1180 DIM block% 99,menu% 99 
1190 ret%=30 
1200 quit%=FALSE 
1210 SYS "Wimp Initialise", 200, &4B53415 
4,"Calculator" 
1220 At=FNicon(-1,"!calc", 0,0, 68, 68, &30 
OA) 
1230 : 
1240 w_calc%=FNcreate_window("Calculato 
r", 446, 884, 388, 408,19) 
1250 DIM exp% (2) 
1260 Y%=-60:FORK%=1T03 
1270 A&%=FNicon (w_calc%, "F"+STRSK%, 8, Y%, 
48,52, &B700302D) 
1280 A%=FNind_icon(w_calc%, exp% (K%-1) ,- 
1,255,"", 62, ¥%, 264,52, &700F325 
1290 A%=FNicon (w_calc%,"C", 332, Y%, 48,52 


* ,&C700302D) 


1300 ¥3-=56:NEXT 

1310 : 

1320 DATA 7,8,9,/, (,),^,4,5,6,*,Hex,1,2 
,3,7,Binary,0,.,E,+,Decimal 

1330 X8=8:Y%=-232 

1340 FORK$=1T022 
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1350 C%=2:IF X%>116 C%=12 
1360 READC$:W%3=48 
1370 IF LEN(C$)>1 W%=156:C%=3 


1380 A%=FNicon(w_calcs,C$,X%,¥%,W%, 52, ( 


C&<<28) +&700302D) 


1390 X%+=W%+6:IF X%=386 X%=8:Y%-=56 


1400 NEXT 
1410 ENDPROC 
1420 : 


1430 DEF FNcreate_window(title$,X%,Y%,W 


%, H, F3) 


1440 Bt=block$: $B%=STRINGS$ (88, CHR$0) 


1450 !B%=X%:B%! 4=Y$-HS :BS! B=X3+WS 


1460 BS!12=¥%:B%!28=F% :B%!32=61000207 
1470 BS!36=&20103:B%!44=-H%:BS! 48=WS 


1480 B¢!56=&19:$ (BS+72)=titles 


1490 SYS "Wimp CreateWindow",,B% TO H% 


1500 =H% 
1510 : 
1520 DEF PROCopen_window(!block%) 


1530 SYS "Wimp_GetWindowState", , block’ 


1540 block%!28=-1 
1550 SYS "Wimp_OpenWindow", , block’ 
1560 ENDPROC 


INVOICING & ACCOUNTS 


New: V3 of The Account Book now available. 
Comprehensive small business accounts to trial 
balance. VAT approved. Absolutely the easiest 

program to use, with neat final books and hundreds 
of reports, No entry limits. "The Account Book gets 
first prize for both price and performance”- 
comparison in Micro User-July "89. A true user - 
friendly program. It succeeds admirably "-Beebug - 
Oct '88. And that was Version 2, V3 has many new 
features. £27.95. 


New: V2 The Invoice Program. The magazines 
havn't had a chance to review this yet, but our 
customers have, and they love it. Database, 
Invoices (unpaid and paid), Statements (individual 
and automatic), Stock presets, Debtor lists, Linking 
with The Account Book and loads more £27.95. 


Special Offer: £49.95 if purchased together. 


Apricote Studios 
2 Purls Bridge Farm 
Manea 
Cambs 
PE15 OND 


Tel: 035 478 432 for information, help or to order. 











1570 : 

1580 DEF FNicon(!block%, text$, L$, B%,W%, 
H%, block%!20) 

1590 block$!4=L%:block$! 8=BS 

1600 block$!1, +H: block’ !16=B3+H% 
1610 IF text$<>"" $(block%+24)=text$ 
1620 SYS "Wimp CreateIcon",,block% TO H 
% 

1630 =H% 

1640 : 

1650 DEF FNind_icon (window’, RETURN buff 
%, block%! 28, len’, text$,L%,B%,W%,H%, F%) 
1660 DIM buff% len%:$bufft=text$ 

1670 block%!24=buff%:block% !32=len%+1 
1680 =FNicon (window%,"", L%, B%, W$, H$, F$) 
1690 : 

1700 DEF PROCquit_menu (X%) 

1710 M%=menu’: $M%="Calculator" 

1720 M$!12=&70207 :M%!16=160:M%!20=44 
1730 M&!24=0:M%!28=680:M%!32=0 

1740 M&!36=&7000029:$ (M3+40) ="Quit" 
1750 SYS "Wimp CreateMenu", ,M%,X%-104,1 
40 

1760 ENDPROC 
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The RISC Dise 
800K of graphics, games, utilities and more! 
This disc Is a great opportunity to extend 
your Archie's capabilities Including: 





© GRAPHICS Mandelbrots, Solids of rotation, 
Fracals, Artwork, Mountains, Ray Traced 
Pictures. 


© GAMES Asteroids, Invaders, Breakout, 
Maze, Speedboat, PacAttack 


® UTILITIES Character Editor, Screen 


Compression, Picture Unrolling, High Res. 
Screen Dump, Full Disc Catalogue, Spherical 
Wrap 


@ ALSO Wordsearch Generator, Database, 
Music Keyboard, !Maestro Scores, New Voices, 
Computer Generated Music, Animated 
Waveforms 








Plus a lot more for only £4.50 inclusive 
Cheque/P.O. To: Matthew Draper, 6 
Eastern Pathway, Queenspark, Chester, 
CH4 7AQ. 
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Of Printers, Drivers and Fonts 


Lee Calcraft takes a look at the major elements involved in getting smart looking 


hardcopy from your Archimedes. 


I, the good old Archimedean days of 
Arthur, if you wanted to send output to a 
printer, you connected it up, sent a Ctrl-B 
(or VDU2), and any text appearing on the 
Archimedes’ screen, was printed out on 
paper. If you wanted to print out a picture 
rather than text, you simply used a 
printer dump for your particular brand of 
printer, and the image would appear on 
paper - though grey scales and coloured 
images tended to be poorly reproduced, 
and the result was usually very dotty. 


But now with the advent of RISC OS, 
there are very many more considerations to 
be borne in mind. You can of course use the 
same old methods that worked with Arthur, 
but a number of new factors have come into 
play which will change the way that we 
view the whole printing process. 


The major changes are twofold: 
the supply of new generalised printer 
drivers to cover the main printer 
types, and the supply of new outline 
fonts, and their use in applications 
such as DTP (desktop publishing) 
packages. 


THE OUTLINE FONTS 

The so-called system font on the 
Archimedes - the default font used by 
the machine for listing Basic 
programs etc. - is only of limited use 
in word processing or DTP. Each 
character is of equal width, and the font 
cannot be scaled to any great degree 
without appearing very ragged. 





The Edit application supplied on 
Applications Disc 1, and both Acorn DTP 
and Impression are able to produce 
printed output in a number of different 
fonts, and in a wide range of type sizes. 
This is achieved on the Archimedes by 
using the sets of fonts variously described 
as the “Fancy fonts”, the “Anti-alias 
Fonts”, and more recently the “Outline 
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This is text in the system font 


ABCDEF abedet 


This is text in Trinity medium anti-aliased font 


ABCDE Fabedef 


Fonts”. Unlike the system font, these are 
proportionally spaced scalable fonts. 


The term anti-alias means that 
software algorithms are used in displaying 
the font on screen which reduce jagged or 
abrupt edges by inserting suitably 
positioned pixels in shades intermediate 
between foreground and background 
colours. See figure 1 for a comparison 
between the Archimedes System Font and 
Trinity anti-aliased font. Though it will 
certainly not be apparent from the figure 
(unless viewed from a long distance), anti- 
aliasing is very effective, particularly in 
the higher resolution modes on the 
Archimedes, and is a technique adopted in 
most professional TV captioning systems. 





Figure 1. A comparison between the system 
font and antl-allased font (much magnified) 


Sets of anti-alias fonts were supplied on 
both the Arthur Welcome Disc and on the 
RISC OS Applications 1 Disc. In both cases, 
the information needed to generate the 
anti-aliased characters on screen was held 
as a number of bit-maps - maps showing 
the relative positions of individual pixels 
needed to make up a given character. Bit 
maps were held in a variety of font sizes, 
but if a particular size was not available, 
the closest size held was scaled up or down. 
Such a procedure takes time, and does not 
produce the highest quality result. 
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To rectify this, Acorn have been 
developing a more advanced system for 
holding font information - Outline Fonts. 
Here font information is stored as a series 
of straight lines and curves specifying the 
outlines of each character. This data is 
converted to an accurate bit-map in RAM 
(in the font cache) whenever a particular 
font is requested. This technique is 
relatively economical on disc storage, 
since for large point sizes a comparable 
bit-map would need to incorporate the 
largely redundant information that each 
pixel within the body of the character is 
turned on. Furthermore the quality of 
output across the range of point sizes is 
typically better. 


Trinity Medium 

Trinity Medium Italic 
Trinity Bold 

Trinity Bold Italic 
Homerton Medium 
Homerton Medium Italic 
Homerton Bold 
Homerton Bold Italic 
Corpus Medium 
Corpus Medium Italic 
Corpus Bold 

Corpus Bold Italic 








Figure 2. Acorn's standard set of outline 
fonts Times, Helvetica and Courler look-alikes 


The outline fonts currently available 
are given in figure 2, together with the 
(copyrighted) names more usually 
associated with them. These fonts are 
supplied with both Acorn DTP and with 
Computer Concepts’ Impression document 
processor; but they may also be purchased 


as a stand-alone item from Acorn dealers © 


for around £50. There are also more fonts 
on the way. BEEBUG are developing a 
selection, including an Avant Garde 
equivalent, while Computer Concepts are 
working on a Palatino, and Acorn will 
shortly be releasing New Century Schoolbook 
and the symbol set Zapf Dingbats. 


Of Printers, Drivers and Fonts 


While the principal use of anti-alias 
fonts on the Arc is for DTP and other 
proprietary software, it is also possible to 
make use of it in relatively simple 
programs. As you might expect, 
generating anti-aliased text is a little 
more complex than printing out in the 
system font, and information on how it is 
done can be found in two RISC User 
articles: Anti-alias Fonts for Humans 
(Volume 1 Issue 3), and Anti-alias Fonts 
in the 256-Colour Modes (Volume 2 Issue 
7). The first of the two deals with the 16- 
colour modes. 


PRINTER DRIVERS 

The anti-alias font system works well 
on screen on the Arc, especially in the 
higher resolution modes with a multi-sync 
monitor. But it presents problems when it 
comes to printout. You cannot use anti- 
aliasing with a mono printer, and you 
certainly cannot just send the characters 
from your DTP or word processor straight 
to the printer as you could with a text file 
created in the system font. Something 
much more subtle is required - and this is 
where the printer drivers come in. 


ss Aa 


lPrinterDM [Printer Tx 


GS B 


'PrinterL] {PrinterPS 





Figure 3. Acorn's printer drivers for dot 
matrix, Integrex colour, HP LaserJet and 
Postscript printers 

A printer driver is a piece of software 
which any Archimedes application can 
access, and which will produce output 
suitable for a particular printer. By 
providing a set of powerful drivers for the 
most commonly used printer types, Acorn 
have made it very easy for application 
writers to generate high quality printed 
output on any of these printers. All the 
application writer has to do is to write a 
piece of code which uses the generalised 


driver protocol. The user then installs the 
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Of Printers, Drivers and Fonts 





driver appropriate to his particular 
printer by double clicking on the printer 
driver’s icon in a directory viewer. He then 
presses the 
button to 
commence 
printout, or 
drags a file 
to the driver 
icon, 


In the 
latter case, 
exactly what 
happens 
next depends 
on the file 
type of the 
dragged file. 
If the driver 
knows of an 
application capable of printing 
out the file, it will automatically 
invoke it, loading it in from disc 
if necessary. If not, it reports 
back to the user, and offers to 














Printouts from the 
standard Draw File 


daisy wheel, with the dot structure of each 
character reasonably well hidden. But 
throughput often suffers considerably, 
with speeds down to 20 or 30 
characters per second. This means that 
a full page of A4 
could take around 
2 minutes to print - 


Draw is the most pow| 
supplied with RISC 
graphics program that 
of basic object types. 

® 








print the file as if it were a © Dot Matrix (9 pin) © Laserjet 150 DPC ® Laserjet 300 DPC 


straight text file. Files of type ASCII 
(FFF) are an exception to this. They will 
automatically be printed out by the driver 
as plain text, using the printer’s standard 
internal font. 


DOT MATRIX PRINTERS 

However good the Arc’s printer drivers, 
the quality of hardcopy will always 
depend on the type and quality of the 
printer used. These fall broadly into two 
camps, the dot matrix and the laser 
printer, though the HP DeskJet - a high 
quality ink jet printer - forms a very 
interesting half way house (of which more 
anon), 


Dot matrix printers are generally well 
suited to producing text output, but 
perform less well where graphics are 
concerned. In terms of quality the new 24 
pin printers give a much better output 
than the 9 pin variety, but cost somewhat 
more. In so-called Near Letter Quality 
print mode (NLQ), the output of both 9 
and 24 pin printers can approach that of a 
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though at typical draft speeds of up to 200 
characters per second, you could print a 
full page in 20 seconds or less. 


Because dot matrix printers are not 
capable of generating the wide range of 
font styles and sizes that the Arc’s anti- 
alias font system can handle, all output 
containing the anti-alias fonts must make 
use of the graphics mode of the printer, 
and build up each page pixel by pixel in a 
similar way to a graphics dump, Because 
this is achieved by successive sweeps of 
the print head, it can result in a certain 
degradation of quality due to poor vertical 
alignment from one sweep of the paper to 
the next. The process can also be rather 
slow and very noisy, but as you can see, 
both 9 and 24 pin printers can give quite 
reasonable results. 


LASER PRINTERS 

If you discount photo-typesetters, the 
best output of both text and graphics will 
always be produced by a laser printer. And 
broadly speaking these come in two types: 
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ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you, 


If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright, 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


If you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 









































Of Printers, Drivers and Fonts 





the PostScript and the non-PostScript. As 
was mentioned in the article last month 
on laser printers, PostScript is a so-called 
page description language invented by 
Adobe Systems inc. Various applications 
packages on the Mac and IBM PC, and the 
PostScript printer driver on the Arc, can 
produce output in PostScript format. This 
is then passed to a PostScript laser 
printer which interprets the program 
code, and writes directly to the printer’s 
bit-mapped RAM, from where it is printed 
out. 


The PostScript code sent to a 
PostScript printer is not just a block of 
data, but is an actual program which is 
interpreted line by line as it arrives from 
the computer, and is executed by a 
processor inside the printer. This whole 
process is very efficient, and with a fast 
processor in the printer, can result in 
astoundingly good throughput figures. 


The alternative approach, and that 
adopted in so-called HP LaserJet 
compatibles, is for the printer driver to 
generate a complete pixel map of the 
required image, and send this to the 
printer. Clearly the processor inside the 
printer has much less work to do in such a 
case, but the printer driver must work 
very much harder, generating information 
about every pixel, even if it is in a blank 
part of the document. 


PRINTER TYPE 
FX 80 (9 pin dot matrix) 
Panasonic KX-P1124 (24 pin dot matrix) 


Panasonic KX-P4450 (LaserJet 150 dpi) 
Panasonic KX-P4450 (LaserJet 300 dpi) 
Apple Laser Writer (PostScript 300 dpi) 





Times taken to print out the standard Draw file supplied on Applications 
Disc 1. Times In parentheses represent ARM processor time 


The table given in figure 5 gives the 
time taken by four different printers to 
print the sample Draw file supplied on 
Applications Disc 1, As you can see from 
this the PostScript laser printer gives the 
best time, and its output is 
indistinguishable from that of the 
Panasonic LaserJet compatible. For this 


DRAW FILE TIMING 

5 mins 15 secs 
12mins 0 secs 
47 secs 

3 mins 31 secs 
1 min 15 secs 


latter machine, we have timed both 150 
DPI (dots per inch) resolution and 300 
DPI output, since the former makes a very 
useful draft mode. 


The times given in parentheses for the 
laser printers are those taken by the 
printer driver to process the file. As you 
can see, this is a very high proportion of 
the printing time for the 300 DPI LaserJet 
output. This is as we would expect, and 
implies that an ARM 3 upgrade would 
very considerably improve the overall 
timing, whereas with the PostScript 
printer, there would be virtually no 
improvement. 


While PostScript laser printers come 
off best in these tests, there are some 
drawbacks to using a PostScript printer. 
The first perhaps is price. PostScript 
printers, as we said last month, tend to be 
considerably more expensive than 
LaserJet compatibles because of the 
licence fees charged by Adobe. But 
PostScript clones are beginning to appear, 
and this is bringing the price down. 
Moreover Microsoft and Apple have begun 
to develop an alternative to PostScript, 
and in response, Adobe has promised to 
waive licence fees on future PostScript 
interpreters, 


A second minor drawback is that all 
fonts which find their way onto paper via 
a PostScript printer must 
be resident in the printer 
(either in ROM or 
downloaded from the 
application). In a LaserJet 
set-up, the application 
creates a bit-image of the 
whole output, so the font 
need only reside in the 
computer. For a PostScript 
set-up, each font must reside in two places, 
and the PostScript driver on the Arc uses a 
customisable file to look up PostScript font 
names, Thus when the printer driver sees 
text in Trinity, it looks up the name of the 
closest PostScript font - Times Roman in 
this case - and (among other things) sends 
this font name to the printer. 


(30 secs) 
(3m 15s) 
(9 secs) 
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Apart from the obvious problem that 
there may be a font which you wish to use 
on the Arc (in the future that is, when 
more are available), but which is not 
available for your printer, there is also the 
problem of small discrepancies in size, 
While Trinity resembles Times very 
closely indeed, some characters differ 
minutely from their PostScript 
counterparts. This could mean that what 
you see on screen is not exactly what you 
get on paper. 


Finally, there are one or two PostScript 
printers (most notably the excellent Qume 
Crystalprint Publisher) which will only 
accept PostScript. This means that you 
cannot print from applications on the Arc 
which cannot use the PostScript driver 
(nor can you use it to print out from other 
computers such as a BBC micro which 
might be in use alongside an Archimedes). 
Thus you cannot print out a Basic 
program on the Archimedes by sending 
Ctrl-B (or VDU 2), and then typing LIST. 


Similarly, the Print option within Twin 
and other packages will not work in 
PostScript mode. To print out from such 
applications using a printer without an 
ASCII mode, you would need to save a 
text file to disc, and then drag it to the 
printer driver icon. This can be a little 
inconvenient. 


A large number of laser printers 
however, have an Epson emulation mode 
which makes use of a standard fixed- 
width Courier-like character set within 
the printer. By switching to this, you can 
use the printer to output relatively 
unembellished text at great speed. Indeed, 
if you need to output long Basic programs 
at speed, the fastest way to do it is to use 
a Laser printer with Epson emulation, 
and use Ctrl-B and type LIST. 


Next month we will take a closer look 
at the Panasonic KX-P4450 LaserJet 
compatible printer. 

AU 





Disc 


CHIMEDES 





1 EMACS. Super editor with language. Now includes full C source. 
2 MicroSpell. 43,000 word real time spelling checker module. 
4 XLISP. Object oriented version of LISP with C source and progs. 
5 C Toolkit. 20+progs for C programmers with sources. grep, awk,.. 
6 Kermit. Archimedes, BBC and MSDOS versions of comms. prog. 
Disc 7 WIMP Chess. Good wimp based chess game with many features, 
Disc 8 CrossStar. wimp based crossword solver with huge dictionary. 
Disc 10 More C Tools. yacc and lex with examples and C source. diff etc. 
Disc 11 Little SmallTalk. original object oriented language with C source. 
Disc 14 GNU Tools#1. high quality tools with source. egrep,sed,awk, diff. 
Disc 15 Clip Art#1 50 pictures, also 65 Epson LQ printer fonts, !Sparkplug 
Disc 16 Spark. Super RISC OS wimp based multitasking file/directory 
archiver. !Backdrop sticky desktop, pd progs, 1Mb. colour pics. 
Disc 18 MTV Raytracer, database driven 3D raytracing package with C 
source code. Lots of fun making pretty raytraced pictures. 
Disc 19 Starchart. wimp multitask program to make Draw file starmaps 
showing positions of stars and planets. Catalog of 9000 stars. 
Disc 20 GNU Tools#2. gnumake. CXRF C source code cross ref. dbase. 
Xfmt simple nroff, pr formatter, M4 macro language. with C srcs. 
Each disc is £5.99 inc. Buy four claim another free! 


David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. Full list available on request. 


Disc 
Disc 
Disc 
Disc 
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Minerva’s Multistore 


Reviewed by Mark Sealey 





"| er System Delta Plus was 
released very shortly after the first 
appearance of the Archimedes, and 
reviewed in RISC User Volume 1 Issue 3. 
Subsequently, Mailshot and Reporter 
added relational, report-writing and 
mailmerge features. Release 2 of System 
Delta was later reviewed in RISC User 
Volume 2 Issue 7. 
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Browsing through a file containing text and 


graphics 


Now Multistore (priced at a somewhat 
pocket wrenching £299) has appeared 
with BBC-and System Delta file 
compatibility, which incorporates all the 
earlier products. However, this is much 
more than a mere RISC OS re-write, 
though it retains the basic card-index 
format and the successful features of the 
earlier software. 


MULTISTORE IN USE 

As with many RISC OS products, 
Multistore (whose main program is still 
written in Basic) installs itself on the 
Desktop icon bar - as now does the Import 


utility. This is capable of handling data © 


from nearly a dozen other formats 
including BEEBUG’s Masterfile and some 
non-Acorn file formats. 


The dialogue and save boxes all behave 
consistently with accepted RISC OS 
practice. Even data and messages from 


files, for example, appear perhaps rather 
unnecessarily in their own separate 
windows. 


Multistore is fully multi-tasking with 
other legally written software, and one of 
the more impressive aspects of the 
package is its genuine internal multi- 
tasking. You can be performing a sort on 
one file and searching another, while 
loading and browsing and printing several 
more with no appreciable loss of speed. 


Many more operations than before - 
including placing fields into search 
criteria boxes - are achieved by use of the 
mouse. This is all to the good, not least 
because it encourages experimentation. 
Since Multistore is so fast, all sorts of 
changes can be made (re-designing card- 
layout, for instance, or trying different 
indexes) and easily undone if not 
successful. 


Gone are the orange and blue panels. 
The video-recorder style icons have been 
kept, though, and appear in an optional 
toolbox pane which is tagged onto the left- 
hand side of the data or file-format window, 
and follows it around. Most of Multistore’s 
major operations (macros, field 
information, reports and searches etc.) are 
accessed from menus associated with this 
toolbox. Others (Like Create, which has 
several new features that are useful in 
editing card-design, and Transfer) appear 
from a menu which comes from the 
Multistore icon on the icon bar. 


From this it should be obvious that 
there has been considerable re-design 
since System Delta Plus - particularly in 
the greater flexibility of searching, and in 
the complete integration in the software of 
report writing, mailmerge and file 
linkage. It is well that everything is 
explained as clearly as it is in the very full 
and well laid-out manual (188 pages, ring- 
bound). To make things easier still, there 
are often two ways to carry out an 
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operation, and on-screen help text if 
required. However, much reference to the 
manual is necessary initially when 
learning to control the package (whether 
to single or double click, and with which 
button, can seem daunting at first). 


REPORTS 

This part of the system has really been 
streamlined. Fully formatted output can 
be produced in up to three fonts, handle a 
variety of data types, and be based on 
subsets or follow index-order, and from 
more than one file if required. There are 
also six types of report, from whole card 
through labels to paged reports with (sub) 
totals, using complex maths formulae to 
generate the output where appropriate. 


[STST FieTaseUATTTLES TS) 
E EJ 


i ets Birthday 
rna 
format)  [9tars 


(8,1) = 14,5 
Fusssal_2 


Create FileFormat) | 





i 
bd Telephone af Index nane; 
Expression: [@Hane 
1 Felurpercase [Soundex ater 
wo D Esc strip string Ei fal 
Mo Blanks (Cancel (OK) 





Creating an index to a file 


Although a potential source of 
confusion, not only are these options 
particularly well explained in the manual, 
but they are also controlled by dialogue 
boxes which are largely self-explanatory, 
avoiding the use of cryptic visual icons as 
Minerva has done in the past. 


NEW FEATURES 

Indexes, which enable you to display 
and use data in an order different to that in 
which the records are stored (alphabetical 
order, for instance) have been introduced in 
Multistore, and feature alongside subsets. 
Both subsets and indexes can have 
meaningful names as well, and the 
definition of one subset can be transferred 
to another. These are welcome 
enhancements and work smoothly. 


One of the more impressive innovations 
is the so-called Fast Sort. Again, operation 
of this option is extremely simple, but no 
other actions are permitted while sorting 
takes place. No wonder, for the speed of 
processing is phenomenal. A 350K file (900 
records) took under two minutes 
(excluding disc access time) to sort from 
scratch on three criteria. In the Soundex 
search option, matches are found 
according to their phonetic similarity (i.e. 
‘sounds like’). Indeed, the number of ways 
in which a database or subset can be easily 
searched has been considerably extended 
in Multistore, making it extremely flexible 
in this respect. 


Submitting data to (repetitive) 
mathematical contortions has been made 
easier too by the introduction of macros. 
These can be edited as text files in Edit, 
say, and stored on disc. This facility is 
important for it means effectively that 
there is now a programmable database for 
the Archimedes that really lacks nothing 
in comparison, say, with the dBase family. 


Data files, which can now take 
advantage of the Archimedes function 
keys for data entry of recurring material, 
can now hold display graphics (held as 
sprites). These could be digitised images, 
or sprites created by other software. Extra 
touches like audible tone-dialling of 
telephone numbers, if held in an address- 
book or mailing list, for instance, indicate 
what a lot has been packed in. There is 
also a notepad which may be invoked (and 
saved) both for temporary jottings, and for 
commonly used searches or sort 
definitions etc. And the card export 
facility allows you to spool data in ASCII 
format to a word processor. 


The capacity of the package is 
phenomenal, with the theoretical 
maximum of records now in excess of two 
billion. Field size and number limits are 
also well beyond what even the most 
demanding of users will require. Of 
course, some of these parameters are of no 
practical value, but an awareness of them 
does add to the impression that Multistore 
is a ‘serious’ tool. 
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This impression is strengthened by the 
degree of user customisation now possible, 
where many parameters and 
configurations can be stored on disc, and 
followed automatically at start-up. This 
will help where memory is tight or when 
the system is to be put to specialised use 
(unusual currency symbols or page- 
widths, for example). There is some 
provision for specialist accountancy 
formats too. 


CONCLUSIONS 

If you are looking for a simple card 
index style of database, then Multistore 
will accommodate you, but it is clearly 
designed for more demanding and complex 
applications (at a price to match). Be 
aware, though, of the limitations of fixed 
field lengths in such packages. It is 
impossible for records in this format to 
grow or shrink as the need arises. In 
compensation, Multistore’s procedure to 
add fields and alter their characteristics is 
very clean and unambiguous. By using 
this, together with straightforward 





relational techniques, many such 
limitations can be overcome - at a price. 


The major new features in Multistore 
are: full exploitation of the Desktop world; 
indexes as well as enhanced subsets; 
soundex; graphical data; superb report- 
writing; macros and the ability to sort at 
very high speed. If you already own and 
like System Delta, and these are features 
which could be important to you, you may 
wish to consider upgrading to Multistore. 


If you can afford £300, and Multistore 
really IS overpriced, then buy it and enjoy 
it. The package will do almost everything 
you want it to extremely well, and it is 
intuitive to use and easy to learn, with the 
capacity and flexibility to meet most 
requirements. 


Product Multistore 
Supplier Minerva Software 
69 Sidwell Street, 
EXETER, 
Devon EX4 6PH. 
Price £299 Inc. VAT. 


(available through BEEBUG) RU 


"FIRST" 
ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; “Industry Standard” machines 


A powerful and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 


Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 
ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 
One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 


There's far too much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 1SD Tel. 051 327 4268 
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Writing RISC OS programs? 
Looking for an alternative to BASIC? 


CAMBRIDGE 
PASCAL 


Full featured Pascal Compiler for the 
Acorn Archimedes 


Cambridge Pascal is a comprehensive version of the Pascal 
language and includes many extra enhancing features over 
the standard specification including 

+ Full dynamic string handling 

* Local error handling 

* Random access files 

e Direct access to ‘star’ commands 

e Access to RISC OS SWI calls 

* 100% Desktop compatible 

e Source files can be written in !Edit or Twin 

e Compilation to absolute code or relocatable modules. 

* Can also be run from the command line 

All programs compile into fast, efficient machine code. 
Pascal is a language much more suited to compilation than 
BASIC, and the code size and speed improves considerably 
even on our own ABC BASIC compiler. You can genuinely 
use this product to produce commercial software. 
Cambridge Pascal requires any Archimedes running RISC 
OS withat least IMb of RAM. Hard discs and extramemory 
are useful, but the system is perfectly workable with this 
minimum configuration. 

The language is also an ideal implementation for students 
of Pascal, and can be used for any coursework in the 
language. The superb error handling and run-time trace 





facility make the language particularly suitable for use in 
education. Tracing of a program's execution can be per- 
formed at source level, to file, printer or screen. 
Cambridge Pascal also supports a wide range of compiler 
directives, allowing disc or RAM-based compilation, inclu- 
sion or exclusion of extensions, conditional compilation, 
$include files, code tracing, and many other options. 

Full run-time textual error messages are supported, and a 
comprehensive intelligible set of errors and warnings are 
used to flag any compile-time problems. 

The $include file system allows you to build up libraries of 
additional procedures and functions, extending the lan- 
guage as you like. Already provided are a collection of 
routines concerning with desktop programming—the crea- 
tion of multi-tasking programs which run from desktop 
windows. 

Cambridge Pascal was written by Paul Fellows, former 
Head of Language software at Acornsoft, and author of the 
Acornsoft S-Pascal compiler, and our own ABC Compiler. 
The price of the package is £79.95 (£69.52+VAT). A free 
demonstration disc and full specification sheet is available 
on request. 

Whether you're just learning or a Pascal expert, then 
Cambridge Pascal is for you. 


_——— ee ee 
DABS Cambridge Pascal is available from all Acorn dealers or in case of difficulty post free from Dabs Press (RU), 5 Victoria Lane, 

Whitefield, Manchester M25 6AL. Tel. 061-766 8423. Fax. 061-766 8425. Access/Visa accepted. Foreign price £69.52 plus 
Va SQ ONS) postage £2.50 (surface) or £12 (air) Full Archimedes or BBC catalogue available on request. 





The Floating Point Instruction Set (2) 


David Spencer completes his look at the ARM floating point instructions. 


FLOATING POINT DATA 
OPERATIONS 

We concluded last month’s article with 
a look at the two instructions used to 
transfer floating point values between 
memory and the FP registers, LDF and 
STF. We will start this month with the all- 
important instructions to perform 
arithmetic on floating point numbers. 


However, before doing this, we need to 
understand about rounding. The FP 
processor effectively performs all 
operations to an infinite precision (as far 
as the user is concerned), and then rounds 
the result to the precision specified for the 
operation. There are four possible ways in 
which this rounding can be achieved, the 
default being known as ‘Round to nearest’. 
This is the most logical, and involves 
rounding the result to the nearest value 
that can be represented within the chosen 
precision. The remaining three rounding 
methods are known as ‘Round to +’, 
‘Round to -> and ‘Round to zero’. The first 
two of these will always round up or down 
respectively, while the third always rounds 
towards zero (up for negative numbers, 
down for positive). In practice you are 
likely to use the default ‘Round to nearest’ 
almost all the time. ‘Round to zero’ can be 
thought of as truncating the value to the 
correct precision. Table 1 shows the effect 
of rounding some decimal number to one 
decimal place using the four methods. 











Value Nearest +c = 0 
5.16 5.2 5.2 5.1 5.1 
-5.16 -5.2 -5.1 -5.2 -5.1 
4.71 4.7 4.8 4.7 








Table 1. Effect of rounding methods 


Now, down to work and the actual data 
processing instructions. As with the 
standard ARM equivalents, all the 
operations take their arguments from one 
or two registers, and write the result back 
to a register. Alternatively, one of the 
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arguments can be a constant, but as we 

shall see shortly, the range is much more 

limited than for the integer data 

operations. The general form of assembler 

mnemonic for these instructions is: 
op<cond>prec<round> Fd, Fm or 
op<cond>prec<round> Fd, #const 

for unary operators, and: 
op<cond>prec<round< Fd,Fn,Fm or 
op<cond>prec<round> Fd, Fn, #const 

for binary operators. 


op is a three character instruction 
name, these being described shortly, while 
the optional cond is one of the sixteen 
standard condition codes. prec is a single 
letter representing the precision to use for 
the result, and can be any of the letters S, 
D, E or P as described last month. round 
specifies the rounding mode, and can be P, 
M or Z to round to +, -oo or 0 respectively. 
If this letter is omitted then the default 
round to nearest is assumed. The register 
arguments Fd, Fm and Fn are floating 
point registers in the range FO to F7, with 
Fd representing the destination, and Fm 
and Fn the arguments. In the case of Fm 
being replaced by a constant, the possible 
values are 0.0, 0.5, 1.0, 2.0, 3.0, 4.0, 5.0 
and 10.0. If any other value is needed, it 
will have to be stored in memory and 
loaded using an LDF instruction. 


Table 2 shows all the data operations 
provided, together with their instruction 
names (op from above). The ones marked 
with a + are supported directly by Acorn’s 
hardware floating point co-processor, 
while the remainder are emulated using 
these core instructions. 


Most of the operations in table 2 
should be self explanatory. The so-called 
fast operations (FML, FDV and FRD) are 
considerably faster than their normal 
counterparts, but produce only single 
precision results. POL performs the 
operation ATN(Fn/Fm). It is used to find 
the angle when converting from cartesian to 
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Binary Operations 


ADFt Add Fd=Fn+Fm 
MUF t Multiply Fd=Fn*Fm 
SUF t Subtract Fd=Fn-Fm 
RSF +t Reverse Subtract Fd=Fm-Fn 
DVF t Divide Fd=Fn/Fm 
RDF t+ Reverse Divide Fd=Fm/Fn 
POW Power Fd=Fn4Fm 
RPW Reverse Power Fd=Fm#Fn 
RMF t Remainder Fd=Rem(Fn/Fm) 
FMLt+ Fast Multiply Fd=Fn*Fm 
FDV t Fast Divide Fd=Fn/Fm 
FRD t+ Fast Rev. Divide Fd=Fm/Fn 
POL Polar Angle Fd=ATN2(Fn,Fm) 
Unary Operations 

MVF Move Fd=Fm 

MNF Move Negated Fd=-Fm 

ABS Absolute Value Fd=ABS(Fm) 
RND Round to Integer + Fd=INT(Fm) 
SQT+ Square Root Fd=VFm 
LOG Logarithm Fd=LOG(Fm) 
LGN Natural Logarithm Fd=LN(Fm) 
EXP Exponent Fd=e#Fm 
SINt Sine Fd=SIN(Fm) 
COSt Cosine Fd=COS(Fm) 
TAN Tangent Fd=TAN(Fm) 
ASN Inverse Sine Fd=ASN(Fm) 
ACS Inverse Cosine Fd=ACS(Fm) 
ATN+ Inverse Tangent = Fd=ATN(Fm) 


Table 2. FP Data Operations 








polar co-ordinates. The remainder operation 
RMF returns the remainder when the two 
arguments are divided (in other words Fn- 
nFm, where n<=Fn/Fm<n+1). A point to 
note is that MNF performs a negated 
move, whereas its integer counterpart 
MVN inverts the argument rather than 
negating it. Finally, RND performs a 
similar operation to INT in Basic. 


Examples of floating point data 
operations are: 

ADFS F2,F0,F1 

POWEZ F5,F1,#0.5 

TANEQE F7,F7 


FLOATING POINT REGISTER 
TRANSFERS 

The next class of instructions to look at 
are those that transfer data between the 
FP processor and the ARM registers (as 
distinct from memory). These broadly fall 
into two categories - transfers involving 
the actual floating point data registers, 
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and those connected with the FP processor 
status and control registers. The first 
category consists of the two instructions: 

FLT<cond>prec<round> Fn,Rd 

FIX<cond>prec<round> Rd, Fm 
These Float (convert integer to FP) and Fix 
(convert FP to integer) respectively. The 
precision must be specified, along with an 
optional rounding mode, and as always, the 
instruction can be made conditional. Fn is 
the floating point register to convert to and 
Fm the register to convert from. Rd is the 
ARM register. Unlike the data processing 
instructions, Fm cannot be a constant. This 
isn’t a restriction in the slightest, because 
FIXing a constant can be performed 
perfectly well using the ARM MOV 
instruction! Examples of these instructions 
are: 

FLTS FO,R3 
Convert the value in R3 into a single 
precision number in FO, and: 

FIXDZ R1,F7 
Fix the double precision value in F7 into 
R1, rounding it towards zero. 


The control and status instructions are: 

WESRd 

RFSRd 

WFCRd 

RFCRd 
All these instructions transfer a value to 
or from an ARM register. RFS can be used 
to read the status flags described last 
month, and WFS performs the opposite by 
writing to them. This is necessary as the 
flags can only be cleared by writing to 
them directly. WFC should be used to 
write the interrupt masks (as described 
last month), and RFC can be used to read 
the value back again. 


COMPARISON OPERATIONS 
The final set of floating point 

instructions are used to compare the 

contents of two registers. There are four 


"different instructions in this class, namely: 


CMF<cond>prec<round> Fn, Fm 

CNF<cond>prec<round> Fn, Fm 

CMFE<cond>prec<round> Fn, Fm 

CNFE<cond>prec<round> Fn, Fm 

All these instructions require a precision 
to be specified, as well as an optional 
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rounding mode. Fm can be replaced with a 
constant if required, subject to the restric- 
tions given earlier. In the case of CMF and 
CMFE, the two registers are compared 
directly, while for CNF and CNFE, the 
second argument is negated first. The 
result of the comparison is reflected in the 
four ARM flags N, Z, C and V thus: 


N set Fn less than Fm 

Zset Fn equals Fm 

C set Fn greater than or 
equals Fm 

V set Numbers are unordered 


For CNF and CNFE, -Fm should be 
substituted for Fm in the 
above. The overflow flag, 
V, will only ever be set 
with CMF and CNF, as 
the other two commands 
would cause an error 
instead, as described 
below. You should also 
note that in the case of V 
being set, both N and C will be clear, 
meaning that they cannot always be relied 
on to be mutually exclusive. 


First Word 
Second Word 
Third Word 


The difference between CMF and 
CMFE (and CNF and CNFE) is that the 
‘E’ version produces an error if the two 
arguments are unordered. This will arise 
when either, or both, of the arguments are 
undefined as the result of a previous 
erroneous operation. To adhere to the IEEE 
standard around which the FP processor 
is designed, you should use the non-E form 
when comparing for equality or inequality, 
and the E forms at all other times. 


PACKED BCD FORMAT 

As well as the single, double and 
extended precision formats described last 
month, there is also a special format 
called Packed BCD. This differs from the 
other formats in that it is not really a 
floating point format. Instead, the digits 
making up the value are stored directly. 
To understand this, look at figure 1, which 
shows how a Packed BCD value is stored 
in three words (twelve bytes). Each ‘box’ 
on the diagram represents four bits, and 
with the exception of the one marked sign, 
each holds a single digit. This digit, in the 
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range zero to nine, is stored as a binary 
value between 0000 and 1001, with 1010 
to 1111 being illegal values. This coding is 
known as Binary Coded Decimal, or BCD 
for short. The digits dO to d18 in figure 1 
represent the digits of the mantissa, with 
d18 being the most significant. Similarly, 
e0 to e3 hold the exponent. The number is 
normalised such that the imaginary 
decimal point lies between d18 and d17, 
and d18 is not zero. In practice, d0 and d1 
are not significant, and e3 must be zero, 
otherwise the range of the FP processor 
would be exceeded. 


Mare 
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sign| e3 | e2| e1| e0| di8| d17| dié6 
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Figure 1 


The remaining four bit nibble, sign, is 
as its name suggests used to hold the sign 
of both the mantissa and the exponent. 
The top bit of the nibble (i.e. bit 31 of the 
first word) holds the sign of the mantissa, 
and is set for a negative number. The 
second-from-top bit performs a similar 
function for the exponent, while the other 
two bits should be set to zero. 


Packed BCD format can be used 
wherever a precision needs to be specified, 
by using the letter P as a qualifier in the 
instruction mnemonic. However, this 
format only really has significance when 
transferring to and from memory. Another 
point to note is that packed BCD is 
considerably slower than the other formats. 
On the positive side, packed BCD has an 
obvious advantage when communicating 
with the outside world. It is much easier to 
convert an ASCII value to packed BCD 
form, or vice versa, than it is to convert to a 
normal floating point form. 


In conclusion, while the floating point 
emulator is not particularly easy to use, 
especially with Basic’s assembler, it is still 
a lot simpler than coding your own 
floating point routines from scratch. uy 


29 





The Archimedes 
Text Processor 








Invoices 
Reports 
Letters 
Statements 
Circulars 
Etc. 
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Premier’s unique Dynamic 
Text feature is a simple yet 
powerful concept which puts 
you the user in complete 
control for the first time. It 
provides - 


+ Automatic data linkage 
between documents. 


* Flexible control over 
document formatting. 


* The simplest printer 
control yet devised. 


A New Type of Program 


Premier’s Dynamic Text and powered command language combine to provide the best solution to text processing 
problems at home or in the office. It puts the user in greater control than ever before, by offering greater freedom 


and flexibility. All program functions may be modified by the user, while command macros may be written to meet 
any specific user requirement. 


All this is available from just one program, which is fully multi-tasking under RISC-OS, and comes complete with 
220 page user guide, separate word-processor manual, key strips, new 10,000 word thesaurus, for just £120 
plus VAT. 


Premier 3 will be available ftom the Ist December 1989. This definitive version é 

includes fast ‘in memory’ data transfer between other applications, extended C le S 

spreadsheet functions, and faster screen refresh, New facilities allow the treie tware 
independent control of screen and printer output. Older version discs may be 

upgraded free of charge (including full notes on disc), or complete with the new 


word processor manual and thesaurus, for £17.35 + VAT. 33, Restrop View, 
Purton, Swindon, 

Premier 3 may be purchased directly by phone, quoting your MasterCard Wilts. SN59DG 
\ccess) or Visa card number, or from your nearest Acorn dealer. Educational Tel: 0793 770021 


discounts and multi-machine licences are available. 


A Screen Compressor/Decompressor 


Nick Smith describes a versatile utility for the speedy and efficient compression 
(and re-display) of Archimedes’ screens. 


T he purpose of the program listed here 
is to compress the screen and palette data 
when saving a screen display as a file on 
disc, and to be able to reload this file (and 
expand it) for display on the screen again. 
Such a utility has many uses. The process 
dramatically reduces load and save times 
(the compression only takes a fraction of a 
second), and it also frees a significant area 
of the disc for other files. 


As an example, it would typically be 
quite possible to store 45 mode 9 screens 
on a single 800K disc using the program - 
compared to only 20 or so normally. The 
program also preserves the current 
palette data when saving a screen so that 
it will be re-displayed in its correct colours 
when reloaded. 


The program assembles a relocatable 
module which can then be used with the 
two star commands *PicLoad and 
*PicSave. This allows the module to be 
used in immediate mode from within 
Basic or in response to the star prompt, or 
from within Basic or ARM assembler 
programs. The use of a relocatable module 
also means that the utility does not 
corrupt any Basic program already in 
memory. 


The module works with all screen 
modes, using a 1K buffer which is 
automatically reclaimed after use. The 
current screen display also remains 
uncorrupted, compared with some other 
screen compression programs. Any screen 
cursor is removed before saving, so as not 
to spoil the image. This is restored after 
the save is complete. 


To create the module, simply type in 
and save the program given in listing 1 
(using the name Squasher). Running the 
program assembles and saves the 
relocatable module under the name 
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Squash. Once created, the module can be 
loaded ready for use by double clicking on 
its icon in the Desktop, or by typing 
Squash in response to the star prompt. 
Screens can then be saved and/or reloaded 
by using either of the two commands 
*PicSave or *PicLoad, followed in each 
case by the name of the file to be used, for 
example: 
*PicSave Screenl 


You can also add to the versatility of 
the system. Entering the command: 

*SET Alias$ScreenSave PicSave%*0 
will ensure that any subsequent use of the 
*SCREENSAVE command is auto- 
matically diverted to use *PicSave. In 
addition: 

*SET Alias$@RunType_600 PicLoad %*0 
will ensure that: 

*<name> 
where <name> is the name of a 
compressed file will be expanded onto the 
screen using Squash, by recognising the 
filetype (see below) of compressed files. 


TECHNICAL NOTES 

The module is written totally in ARM 
Code, and preserves all registers over its 
operations, allowing it to be integrated 
into other ARM programs. The module 
itself is just over 1200 bytes long. It uses a 
fast and effective ‘run-length’ encoding 
system that achieves an average file of 
approximately 45% the original size (but 
may be worse for complex images). 


It uses its own filetype to identify 
compressed screens - &600. This is in 
the Acorn allocated range for user 
programs, and so won’t clash with any 
commercial software. 


In addition, it uses the module 
‘Service-call’ documented in the PRM to 
intercept the filetype decoding call - the 
result is that any *Ex or *Info will 
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correctly identify a squashed file, as will 
the Desktop, once the module has been 
loaded. 


The loading routine has a unique 
feature whereby if a hex address is added 


after 


the filename, the screen will be 


decompressed to memory rather than to 
the screen. This would allow separate 
routines to perform more complex visual 
effects on it, e.g. 3D-Scroll, sideways load, 


fade, etc. 
10 REM >MakeSquash 
20 REM Program Squash Module 
30 REM Author Nick Smith 
40 REM Version A 1.00 
50 REM RISC User December 1989 
60 REM Program Subject to Copyright 
70: 
80 MODE 0 
90 DIM code% 1500 
100 : 
110 pc=15:;:link=14:sp=13 


120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 


OS_WriteI=&100 


FOR pass%=4 TO 7 STEP 3 
P%$=0:0%=code% 


(OPT pass% 

EQUD 0:EQUD init:EQUD 0 

EQUD service:EQUD title 

EQUD help:EQUD commands 

title 

EQUS "ScreenSquasher":EQUB 0;:ALIGN 


„help 

EQUS "Screen Squasher "+CHR$ (9) 
EQUS "1.00 ("+MID$(TIME$,5,11)+")" 
EQUB 0:ALIGN 

«commands 

EQUS "PicLoad":EQUB 0:ALIGN 


EQUD load:EQUD &2FF01 

EQUD ldsyn:EQUD ldhlp 

EQUS "PicSave":EQUB 0:ALIGN 

EQUD save:EQUD &1FF01 

EQUD svsyn:EQUD svhlp:EQUD 0 
.ldhlp 

EQUS "*PicLoad loads a compressed 


screen, optionally into a hex address." 


360 
370 
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EQUB 13 
.ldsyn 


380 





EQUS "Syntax: *PicLoad <filename> 


[<base_addr>]":EQUB 0:ALIGN 


390 
400 


.svhlp 
EQUS "*PicSave compacts and saves 


the current screen.":EQUB 13 


410 
420 
:EQUB 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 


.svsyn 
EQUS "Syntax: *PicSave <filename>" 
O:ALIGN 

Service 

TEQ R1,#&42:TEQEQ R2, #4600 
BNE noclaim 

.claim ADR R1,name 

LDMIA R1, (R2,R3}:MOV R1, #0 
.noclaim MOV pc, link 

.name EQUS "Squashed" 

-load 

STMFD (sp)!, {RO-R12, link} 

LDR R12, [R12] :MOV R8,RO 

MOV R1,RO:MOV RO, #64 

SWI "OS_Find":MOV R9,RO 

MOV R1,RO:SWI "OS_BGet" 

MOV R11,RO:MOV RO,R8 

MOV R1,R12:MOV R2, #256 

ADD R2,R2,#(1<<29) 

SWI "OS_GSTrans":SUB RO,RO, #1 
MOV R1,RO:MOV RO, #16 

ADD RO, RO, #(1<<31) 

SWI "XOS_ReadUnsigned" 

MOVVC R6,R2:MOVVS R6, #0 

MOV RO, #135:SWI "OS Byte" 
CMP R6,#0:BNE nochange 

CMP R11,R2:BEQ nochange 
«change SWI OS WriteI+22 

MOV RO,R11:SWI "OS Writec" 
„nochange SWI "OS RemoveCursors" 
MOV RO,R11:MOV R1, #3 

SWI "OS_ReadModeVariable" 
MOV R5,R2:MOV RO, #4 

MOV R1,R9:ADD R2,R12, #2 

ADD R3,R5,R5,ASL #1 

ADD R3,R3,#6:SWI "OS_GBPB" 
MOV R8,R4:ADD R5,R5, #1 

MOV R4,#0:MOV R3,R12 

CMP R6,#0:BNE jump2 

-R4_loop STRB R4, [R3] 

MOV RO, #16:CMP R4, R5 

MOVEQ RO, #24:STRB RO, [R3, #1] 
MOV RO, #12:MOV R1,R3 

SWI "OS _Word":ADD R3,R3, #3 
ADD R4,R4,#1:CMP R5,R4 

BGE R4_loop:BL read_screendata 


RISC User December 1989 


A Screen Compressor/Decompressor 





860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 
990 
1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
n 
1120 
1130 
` les" 
1140 
1150 
1160 
1170 
[R12] 
1180 
1190 
1200 
1210 
1220 
Byte" 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
#8 
1310 


B skip this 

.jump2 MOV RO,R11:MOV R1, #7 
SWI "OS_ReadModeVariable" 

MOV R10,R2:MOV R11,R6 

„skip this MOV R6,R11 
.ldouter_loop MOV R7,R12 

MOV RO, #3:MOV R1,R9:MOV R2,R12 
MOV R3, #&410:MOV R4,R8 

SWI "OS_GBPB":MOV R5,R3 
-ldinner_loop LDRB RO, [R7] 
LDRB R1, ([R7, #1) :CMP R1,RO 

BNE ldfailed_IF:LDRB R1, [R7, #2] 
.ldin_loop STRB RO, [R6, R1] 
SUBS R1,R1,#1:BCS ldin_loop 
LDRB R1, [R7, #2] :ADD R6, R6, R1 
ADD R7,R7,#3:B ldjump_me 
-ldfailed_IF STRB RO, [R6] 

ADD R6, R6, #1:ADD R7,R7, #1 
.ldjump_me SUB R0,R7,R12 

RSB R1,R5, #1024:CMP RO,R1 

BLE Idinner_loop:ADD R8,R8,RO 
CMP R5, #&410:BNE ldouter_loop 
B close 

-read_screendata 

STMFD (sp) !, {link} :MOV RO,R11 
MOV R1,#7:SWI "OS_ReadModeVariable 


MOV R10,R2:ADR RO,store 
ADD R1,RO,#8:SWI "OS_ReadVduVariab 


LDR R11, [R1] :LDMFD (sp) !, {pc} 
„store EQUD 149:EQUD -1:EQUD 0 
„Save 

STMFD (sp) !, {R0-R12, link} :LDR R12, 


MOV 
SWI 
SWI 
MOV 
SWI 


R4,RO:MOV RO, #128:MOV R1,R4 
"OS_Find":MOV R9,RO 
“OS_RemoveCursors" 

RO, #18:MOV R1,R4:MOV R2, #&600 
"OS File" :MOV RO,#135:SWI "OS_ 


MOV 
SWI 
SWI 
MOV 


R11,R2:MOV RO,R11:MOV R1,R9 
"OS_BPut":MOV RO,R11:MOV R1, #3 
"OS_ReadModeVariable" 
R6,R2:ADD R6,R6, #1 

MOV R5,R12:MOV R4, #0 

-R4_loop MOV RO,R4:MOV R1, #16 

CMP R4,R6:MOVEQ R1, #24 

SWI "OS_ReadPalette":MOV RO,R2,LSR 


STRB RO, [R5],#1:MOV RO,RO,LSR #8 


1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 


f 


1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 


opl 


, 


1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 


1730 : 


1740 
1750 
o% 

1760 


1770 


STRB RO, [R5], #1:MOV RO, RO, LSR #8 
STRB RO, [R5], #1:ADD R4, R4, #1 

CMP R6,R4:BGE R4_loop 

SUB R5,R5,R12:MOV RO, #2 

MOV R1,R9:MOV R2,R12:MOV R3,R5 
SWI "OS_GBPB":BL read_screendata 
ADD R10,R11,R10:MOV R5,R11 
«Sv_loopl MOV R6,R12 

«Sv_loop2 LDRB RO, [R5] 

LDRB R1, [R5, #1] :CMP R1,RO 

BNE svother_code:CMP R5,R10 

BGE svexit_maincode:STRB RO, [R6] 
STRB RO, [R6, #1] :MOV R7, #0 
.new_loop LDRB R1, [R5, R7] 

ADD R7,R7,#1:CMP RO,RL 

BNE svexit_newloop:CMP R7,#255 
BGT svexit_newloop:ADD R2,R5,R7 
CMP R2,R10:BGT svexit_newloop 

B new_loop 

»Svexit_newloop SUB R1,R7, #1 
STRB R1, [R6, #2] 

ADD R5,R5,R1:ADD R6,R6,#3:B svendi 


.«Svother_code STRB RO, [R6] 

ADD R5,R5,#1:ADD R6,R6, #1 

.svendif SUB RO,R6,R12 

CMP RO, #1024:BGT svexit_maincode 
CMP R5,R10:BGT svexit_maincode 

B sv_loop2 

.Svexit_maincode MOV RO, #2 

MOV R1,R9:MOV R2,R12:SUB R3,R6,R12 
SWI "OS_GBPB":CMP R5,R10:BLT sv_lo 


«close 

MOV RO, #0:MOV R1,R9:SWI "OS Find" 
SWI "OS_RestoreCursors" 

LDMFD (sp)!,{RO-R12,pc} 

init 

STMFD (sp)!,{link}:MOV RO, #6 

MOV R3,#&410:SWI "OS Module" 

STR R2, [R12] :LDMFD (sp)!, {pc} 

] 

NEXT pass% 

name$="Squash" 

SYS "OS File", 10,name$, &FFA, , code% 


PRINT' "Module saved as '"name$"'." 


END 
RU 
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SILICON VISION 


SOFTWARE FOR THE ARCHIMEDES COMPUTER SYSTEM 


RosoLOGO | 





This revolutionary new extension to 
traditional LOGO. made possible only 

by the enormous computational power 
of the Archimedes. provides three 
dimensional control of an articulated 
humanoid or animal figure through the 
use of a standard LOGO language. 
Sophisticated natural commands such 
as Walking Turning. Bowing, and 
Picking. etc are automatically 
represented graphically by natural 
movements of the 3D figure. This natural 
form of graphical response is readily 
understood by students using LOGO to 
learn the concepts of logic & reasoning. 
The traditional Turtlegraphics & 3D Glider 
features are also supported tor easy 
transition to this innovative concept in 
natural response LOGO, 


£69.95 (ARC) New 





REALTIME SOLIDS MODELLER 

The package includes both the 
sophisticated design environment of 
SolidCAD and the high-speed capability 
of a Realtime Graphics Language module 
to provide the fastest programmable 
animation facilities bringing any design 
to life from within your own programs. 
Facilities include 3D Rotate. Scale. Orbit, 
Perspective, Position & extensive display 
styles tor wireframes. hidden-surtace 
removal, smooth shading and multiple 
light sources with indiv jal intensities. 


£89.95 (ARC) New 





GATE ARRAY DESIGN SYSTEM 
An introductory course tor teaching 
Silicon Chip Design with facilities for 
Array design. Cell design On-line Help 
and a tutorial on integrate 
design. Ideal as a low cost teaching tool 
where expensive silicon fabrication 


facilities are not required 


£89.95 (ARC) New 








FILM-MAKER 


ge 
mi 


Corea Ere PEP an ee 


The package provides an interactive 
environment to create animated 
sequences of 3D scenes with dynamic 
camera motion for ‘walk-throughs and 
Hlight-paths: for objects within the scene. 
The fully graphical environment requires 
no programming or textual entry and the 
capability to calculate smooth shaded 
trames of complex scenes with lighting 
effects at rates of 60 minute allows fast 
interactive design of animated 
sequences. A large number of these 
frames can then be stored using built-in 
compression facilities to play-back at 
video scan rates for on-screen animation 
or video recording. Fully compatible with 
SolidCAD and SolidsRENDER, animation 
Oscars are now within your reach, 


£79.95 (ARC) New 





So.inCAD 


The next generation CAD package 
combining 2D Draughting and 3D 
Modelling techniques with advanced 
smooth shading and lighting effects to 
provide the ultimate 3D Draughting 
System for Architectural design, Interior 
design. Engineering design and Teaching 
CDT. Allows drawing in plan, front & side 
elevations and also directly in 3D to 
visualise a model while it is being 
created. Powerlul zoom. pan, sweep, 
extrude and macro facilities are also 
provided to enhance design productivity. 


£49.95 (ARC) New 


SoLinoTOOLS 


The fully integrated environment for 3D 
CAD, Animation, Rendering & Hardcopy. 
The package includes SolidCAD, FILM- 
Maker, SolidsRENDER. Realtime 
Graphics Language. SuperDump & 
SuperPiat for a turnkey solution 
satistying all your requirements. 


£275.00 (ARC) New 


All Archimedes software run in native mode on A305-A440 & A3000 with Arthur 1.2 or RISC OS 
SILICON VISION LTD, SIGNAL HOUSE, LYON ROAD, HARROW 
MIDDLESEX HA1 2AG. TEL: 01-422 2274 or 01-861 2173 
FAX: 01-427 5169. TELEX: 918266 SIGNAL G. 

FX (Access/Mastercard/Eurocard/American Express accepted) 
All prices include VAT and Carriage (Overseas orders should add £4) 





ARC-P. 


PROFESSIONAL 


elu} 
o o 0 9 o o o o ool 


LLLETTETEELII 
jpoovscce 


The ultimate PCB design package 
developed specifically for the 
Archimedes is now even better. 
ARC-PCB Professional follows on the 
success of the original and provides 
Faster & Improved Automatic Routing, 
Oval & Circular pads with fully variable 
sizes, Faster Redraw. Extended library 
part manipuiation, & Instant Editing 
operations for substantially increased 
productivity. This Professional version 
operates orders of magnitude faster than 
the original and surpasses all other PC- 
based PCB design systems in features & 
speed of operation for the fastest 
turnaround trom concept to finished 
board design. Take the lead for your PCB 
designs before your competitors do. 


£375.00 (ARC) New 





SotiosRENDER 


The fastest most advanced Ray Tracing 
package for the Archimedes producing 
photo-realistic images of SolidCAD 
designs or FILM-Maker animations which 
take into account light sources, 
reflections, shadows, transparencies, 
refractions and textures for the highest 
quality pictures from the leading 3D 
graphics experts renowned for technical 
excellence. 


£79.95 (ARC) New 


RiscBASIC 


The best BASIC V compiler money can 
buy. Here's what the reviewers say 

"If you are looking tor THE compiler to go 
for. and are confused about which one 
deserves to win the very public battle 
that has been raging in the 
advertisements, well my preference is for 
RiscBASIC” - RISC USER Aug 1989. 

“In summary, BASIC V is the best version 
of BASIC produced and RiscBASIC 
provides the most compatible, fastest 
compiler for this language. My 
congratulations to Silicon Vision" 
- Archive June 1989. 

very useful indeed for development 
work...produced significantly more 
efficient code” - Micro User July 1989. 
£99.95 (ARC) New 


Readable 'Read Me's 


by David Pilling 


H ave you ever tried reading a Read-me 
file from the Desktop? In all probability, it 
scrolled past too quickly for you to read, 
with words unceremoniously cut at the 
right hand edge. 


ArcScan Release Hotes 


This software is version 2:15, This number should be quoted in all 


correspondence, 


Additional entries have been added to the RISC 05 Programmer's 

Reference Manual index to reflect the chapter and sec on, bendings 
a file 0 

her entries, the letters 'fF' (following) 


of this work. iy are grouped at the start of the da 


distinguish then from o 
are used after the Page fuaber 


complete list of chapter headings by searching for 


Please note that the data for all Acorn indexes in this database 
not be copied or used in any 


It must 


carries a taint copyright, 
permission fron the copyright holders, 


way withou' 


Typical display (from ArcScan Il) using [ReadMe 


It is however, very easy to avoid the 
problem. The accompanying !Run file is 
virtually all that you need. The idea is 
that you use an application called 
!ReadMe. When you double-click on this 
from the Desktop, the screen clears, and 
your text appears in a large full-width 
window, which is scrolled by pressing the 
Shift key. Pressing any key at the end 
takes you back into the Desktop. 


The easiest way to create the 
application is to use the Application 
Generator Utility listed elsewhere in this 
issue. Answer the prompts, giving the 
application name as $.!ReadMe. Answer 
“N” to the offer of a !Run file, and place 
the words “ReadMe” on the sprite. 


You could therefore display the 
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Finally, you need to 


Poen create a special !Run 
e Obey file containing the 
IRead Me contents listed here 


(unusually, the appli- 
cation does not need a 
!RunImage file). The 
easiest way to do this is 
to use Edit, and click 
Menu, and click on 
Create New Obey File. 
Enter the lines of code in 
the listing, and save the 
file to the newly created 
directory ($.!ReadMe), 
Now, place a suitable 
text file (e.g. someone 
else’s Read-me file) into 
the directory, rename it 
“TextFile”, and the job is 
done. 


Note: to alter the 
colours used, you need to 
change the numbers 
which follow each <17> 
in the listing. Numbers 
above 127 indicate 
background colours. For example, to 
change the main background to red with 
yellow text, alter the fourth line from the 
bottom to read: 

echo<17><129><17><3><12> 


|!Run obey file 

|>!ReadMe. !Run 

Run file for !ReadMe Help Program 
echo<22><12> 
echo<28><0><31><79><0><17><134><12> 
echo<17><4><31><33><0>SHIFT to Continue 
echo<28><0><30><79><1> 
echo<17><132><17><7><12> 

echo<14> 

type <Obey$Dir>.TextFile 

echo<15> RU 
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R Now includes indexes to Archimedes manuals 
lArcScan 


Use ArcScan II's rapid keyword searches to find all the references you need! 


NYE Buer data regent 


RISC User Volumes 1 - 2 
Matt ia BEEBUG Volumes 1-8 
The Indexes to the following Archimedes 

agate KELESI Acorn enwais: 
pan paor te Basic User Guide (Arthur) 
rre = a Programmer's Reference Manual (Arthur) 
i trian oe RISC OS User Guide 

vigil RISC OS Basic Manual 
Ute tis RISC OS Programmer's Reference Manual 


ARCSCAN II 


BIS Goer sard search 
fre tassals Sede ela pitt 
Fast ARM Code searching sens File et et” 
Mouse controlled It is often goal to td this vilgerd, 
Runs from the Desktop pe = ork A users ined 
Keyword entry with KATANA custom file 
selectable logic Ey ine alone oeny 
Fully customisable i iota fi fate ee ig customisation 
Extensive on-screen help for other data. 
Hard copy options te ne irene tues ten 


1. If you need to know about Obey Files, enter the words ‘obey’, ‘files' and click on the AND logic. 
All finds in RISC User will be instantly displayed. You can now call up the Acorn Manuals indexes and 
repeat the search to get further references. 

2. To find the "SWI name” for SWI &400D4, select the new Programmers Reference Manual from 
the menu, enter and quote "SW! &400D4", and the answer appears, complete with page references. 


Please send me: 


ArcScan II Discand manual  Code0109AL] ArcScan Upgrade Code 0110A hd 

Price £14.95 members (£18.95 non-members) Price £7.95 members (£10.95 non-members) 
For upgrade, please state month of purchase of RU Special Disc... 

Name 

Address Cost £ 

Postage (£0.60) £ 

Membership No. Total £ 











I enclose a cheque for £ OR please debit my Access, Visa or Connect account, Card 
No / / / Expiry. / Signed. 
Return to BEEBUG Ltd, 117 Hatfield Road, St Albans, Herts AL1 gs elephant (0727) 40303. 
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Part 3 


David Spencer continues his look at the Archimedes hardware. 


DIRECT MEMORY ACCESS 


We start off this month by concluding 
our look at the memory controller, MEMC. 
All the major functions of this chip were 
described last month with the exception of 
one very important one - Direct Memory 
Access (DMA). To understand what DMA 
is, and how it works, we need to consider 
the way in which various parts of the 
system access RAM. Normally, the ARM 
processor is in control, and it reads and 
writes RAM as described last month. 
However, an area of RAM is used to hold 
the data that makes up the video display, 
and hence the video controller - VIDC 
(which we will look at in detail shortly) 
also needs to access the memory. Without 
going into the calculations, in high 
resolution modes VIDC needs to read 
16Mbyte of data from RAM every second. 
At this massive rate, there is no way that 
the operation could be done by using the 
ARM to read a value and send it to VIDC. 
Instead, VIDC has to have a means of 


accessing the RAM directly. 


Direct memory access, as this process 
is called for obvious reasons, 
implemented entirely within MEMC. 
Indeed, when a DMA operation is started 
(by VIDC asserting a signal), the ARM 
processor is stopped by holding the g1 
clock (described last month) high, and 
setting a couple of signals to put the data 
and address buses into tri-state mode, as 
explained in the first part of this series. 
Hence, for all intents and purposes the 
ARM processor is effectively removed from 
the circuit temporarily. MEMC then uses 
an internal pointer to provide a memory 
address, and generates all the necessary 
signals to perform a read operation. When 
the memory has been accessed, MEMC 
generates a signal to VIDC informing it 
that the data is available, and VIDC 
responds by reading it. When the 
operation is complete, MEMC increments 
its internal pointer ready for the next 


DMA operation. 
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To speed up matters, each DMA 
operation is used to transfer four words 
(sixteen bytes) of data. This is done 
because the fast page mode of accessing 
the memories can be used, as described « 
last time. You might wonder, why limit 
the operation to four words at a time? 
Well, remember that the ARM processor is 
halted for the duration of the DMA 
operation, and if too many memory 
accesses were allowed, the computer’s 
operation would appear very ‘jerky’, 
particularly in hi-res modes. 


There are in fact, three separate DMA 
systems built into MEMC, each handling 
different requests from VIDC. The main 
one, as already mentioned, is used to read 
the data that makes up the display. The 
second system is used for the data making 
up the pointer (or cursor as it is called in 
VIDC terminology), which can be thought 
of as a mini display overlayed on the main 
one. The third DMA system provides the 
data needed to generate sound, which is 
also handled by VIDC. This is explained 
in more detail shortly. 


INTO VIDC 

The next chip in the ARM set for us to 
look at is VIDC. As its names suggests, 
the prime function of this chip is to 
generate the video display. The 
Archimedes’ display, and indeed those of 
most other computers, is generated as a 
series of dots arranged into many lines. 
Each line is displayed in turn until the 
whole screen has been filled. The entire 
process is repeated continuously, and the 
relatively slow response of the eye ensures 
that the display appears solid, rather than 
as a series of lines shown one after the 
other. The set of lines making up one 
whole screen is referred to as a Frame. 
The colour of each dot, or pixel, is 
determined by data held in RAM, and 
accessed through the DMA system just 
described. 


37 


Under the Lid 


38 





Put very simply, all VIDC has to do to 
produce the display is to read the data 
from RAM at the correct time, convert the 
value of each pixel into a form suitable for 
sending to a monitor, and output it. And 
basically, this is all that VIDC does. There 
is however the added complication that 
the scanning of the electron guns making 
up the monitor display must correspond 
exactly to the scanning of memory by 
VIDC. To ensure this is the case, 
additional signals called Sync pulses are 
used. There is one pulse at the end of each 
line of the display (the so-called line sync), 
and then a longer frame sync pulse at the 
bottom of each frame. These signals are 
combined and fed to the monitor, which 
uses them to synchronise its scanning to 
that of VIDC. 



































Figure 1. VIDC screen layout and register 


A further complication is that because 
of the vast array of screen modes available 
on the Archimedes, VIDC needs to be 
highly programmable, and no less than 
fifteen registers are used to specify the 
necessary display parameters. Figure 1 
shows a typical display layout, with a 
border, and the pointer somewhere on the 
screen, The names around the diagram, 
such as VCR and HBSR refer to registers 
within VIDC. The registers fall into two 
sets - horizontal and vertical registers. 


Horizontally, the registers determine 
the total width of the display, the length of 





the line sync pulse, the start and end of 
the border (with respect to the left-hand 
edge), the start and end of the actual 
display, and the position of the pointer. 
The values specified in the horizontal 
registers are always in terms of pixels. For 
example, if the register HDSR contained 
the value 100, then the display would 
start 100 pixel widths from the left-hand 
edge of the screen. The vertical registers 
perform a similar function, except that 
they are programmed in lines, rather than 
pixels. The values programmed into each 
register depend on the mode and monitor 
type, and RISC OS keeps tables of all the 
values for each possibility, and sets them 
up accordingly. 


So what does VIDC do with the video 
data when it receives it? Each byte of data 
will represent one, two, four, or eight 
pixels, depending on how many colours 
are allowed in the current screen mode. 
For example, a 256-colour mode has just 
one pixel per byte, whereas a 4-colour 
mode squeezes four pixels into each byte. 
However many pixels there are per byte, 
VIDC extracts and processes each one in 
turn. 


For all but 256-colour modes, VIDC 
uses the data for each pixel to access a 
very fast memory that constitutes the 
palette. The logical colour of the pixel (i.e. 
the data stored in memory) is used to 
address the palette, and the data from the 
palette determines the actual displayed 
colour. This data is in the form of three 
four-bit values, each of which is converted 
to one of sixteen signal levels using a 
device called a Digital to Analogue 
Converter (D to A). The three resulting 
analogue signals, representing the red, 
green and blue components of the display, 
pass through some simple circuitry 
external to VIDC, and then straight on to 
the monitor itself. For 256-colour modes, 
the situation is different because VIDC 
only contains a sixteen entry palette 
memory. In these modes, four bits of the 
pixel data address a palette location, and 
the other four bits are passed directly into 
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the D to A converter, being combined with 
the output from the palette memory. By 
default, RISC OS programs the palette 
memory in 256-colour modes to produce 
the normal colour and tint representation. 


SCROLLING 

An interesting aspect to look at is how 
RISC OS scrolls the screen display when 
the cursor reaches the bottom. An 
obviously method would be to move the 
contents of screen memory up by one line 
in software. However, block moves of 
several hundred K don’t come cheap in 
terms of time, and such a system would 
prove to be too slow. Instead, use is made 
of a register within MEMC which 
determines the address to which the 
display DMA pointer is set at the start of 
each frame (in other words the address of 
the first byte to be displayed). If this 
address is increased by the length of one 
line of characters (in terms of memory), 
then the screen display will start one line 
later and the scrolling will have been 
achieved without moving memory. MEMC 
will automatically wrap around the 
pointer when it gets to the end of the 
memory used for the display, and 
therefore the memory containing the line 
‘lost off the top’ can now be used for the 
new bottom line. 


SOUNDING OUT 

The other function performed by VIDC 
is that of generating sound. While many 
computers use highly complex, but 
inflexible, sound generators, the 
Archimedes instead puts a lot of the onus 
on to software. Indeed, all the hardware 
does is to take data from memory at a 
programmable rate, convert it to an 
analogue signal, and output it. This 
method has the disadvantage that the 
software must construct a digitised 
version of any sound it wants to make, all 
of which takes time and memory. 
However, on the plus side, any sound can 
be produced, and VIDC doesn’t know or 
care whether the data it processes 
constitutes a simple beep or something as 
complex as sampled speech. 
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The sound data which VIDC receives 
from memory via the sound DMA system 
described earlier is treated as a sequence 
of bytes. Of each byte, one bit is used as a 
sign bit, to indicate whether the resulting 
analogue signal should be positive or 
negative. The remaining seven bits allow 
128 different levels to be represented. 
However, rather than using these to 
represent a linear scale, a logarithmic 
system is used. Three of the seven bits are 
used to choose one of eight ranges on an 
exponential scale, and the other four bits 
select a level within that range. This 
method is necessary because the response 
of the human ear is logarithmic, and a 
linear system wouldn’t give a wide enough 
range of perceived loudness. 


VIDC supports up to eight channels of 
sound, and these are handled by 
interleaving the samples for each channel. 
For example, for two channels, the first 
byte of sound data is the first sample of 
channel 1, the second byte is the first 
sample of channel 2, the third is the 
second sample of channel 1, and so on. 
Stereo is handled by eight registers in 
VIDC, each holding the stereo position for 
one channel. As VIDC processes each 
sound sample, it uses the value from the 
appropriate register to decide how much 
of the analogue output to send to the left 
channel output, and how much to the 
right. In fact, what actually happens is 
that VIDC switches the output to first the 
left channel, and then the right channel. 
The stereo position is determined by how 
long the output is switched to each 
channel, 


The only sound circuitry outside of 
VIDC is a filter which smoothes out the 
sound, and a simple amplifier to drive the 
internal speaker. For more details of the 
sound system from a software point of 
view refer to the Programmer’s Reference 
Manual. 


Next month we conclude this series 
with a look at the remaining chip in the 
ARM chipset - IOC, and some of the 
peripheral chips. RU 
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ARCHIMEDES SOFTWARE 





HOME ACCOUNTS; ANCESTRY 
£49.95 £79.95 








Keep your home or club finances in order.| The ultimate in computerised genealogy! 


Full control of multiple bank accounts for use in families or pedigree animals. 
including credit cards and building Use added card index for extra data or 
societies. Budgeting facility to assist photos of individuals. Demo file 
cashflow prediction. Graphs of contains illustrated Royal Family 
budgets and expenditure. Caters tree. Vertical or horizontal 
for standing orders, transfers, ATELI ER printout of family tree. 
statement reconciliation, etc. For home, hobby or 


(Multi-tasking if using educational use. 
RISC OS.) £99.95 (RISC OS compatible) 
& 0392-43756 $ 








Prices = Access & 
inclusive Professional quality art package. Probably the most Barclaycard 
OLYAN sophisticated sprite editor available. Animation of image noce pled 


sequences with Quantel-style graphic effects. Anti-alias 
squashing, rotation of areas into any quadrangle, and sprite and 
brush patterning. Further features allow IV-style techniques to 
even wrap a picture around a 3D surface 
(Multitasking if using RISC OS.) (To be released soon). 


AAAI EEG A 


69 SIDWELL STREET, EXETER. EX4 6PH - Tel: (0392) 437756 Fax: (0392) 421762 





R elease 1 of Acornsoft’s ANSI C 
compiler was available shortly after the 
launch of the Archimedes (reviewed in 
Volume 1 Issue 2 of RISC User). However, 
the manual was brief, to say the least, and 
the library functions offered little beyond 
the basic Wimp routines. Release 2 
appeared at the beginning of 1989, but 
apart from being able to use a shared C 
library and working with Acorn’s symbolic 
debugger, it had little in the way of new 
features. Now comes release 3, with a 
detailed manual and a host of library 
functions enabling Wimp based software 
to be developed with ease. 


THE C PROGRAMMING LANGUAGE 

C is a compiled programming 
language, producing very efficient code, 
which allows the programmer access to 
the features of a machine at a low level. C 
was originally designed by Dennis Ritchie 
to implement the UNIX operating system. 
It is not a particularly ‘big’ language, with 
most of the facilities being provided by 
library functions. This gives it a large 
degree of generality, enabling it to be used 
in areas ranging from low level system 
routines such as interrupt handlers and 
device drivers through to complex 
applications. 


As C is a compiled language, unlike 
Basic which is normally interpreted, there 
is no concept of being ‘in’ C. A C program 
is normally developed in a text editor, like 
Edit or Twin, and then compiled by 
executing a star command, This produces 
an object file, which is linked in turn with 
library procedures to produce an 
executable machine code program. 


A C program is simply a collection of 
functions, one of which is entitled main. 


RISC User December 1989 


Acorn's ANSI C (Release 3) 


Glynn Clements assesses the worth of the latest release of Acorn’s C compiler. 


This is the function which is executed 
when the program is run. When the 
program is compiled, the resulting object 
file consists of compiled versions of the 
functions in the source program. The 
object file is then linked with one or more 
library files. 


A library is essentially just a 
collection of routines. Every library has 
associated with it a collection of header 
files. These are C source files which 
describe the library functions, so that 
the compiler can check that they have 
been used correctly. Release 3 of C is 
supplied with two main libraries; the C 
library, which contains the functions 
specified in the ANSI C standard, and 
the RISC OS library, which contains 
functions for machine-specific features, 
such as window management and 
memory allocation. It is the latter which 
allows Wimp applications to be created 
with ease. It includes functions for 
displaying Draw files, displaying text in 
a window (and allowing the text to be 
edited), loading and saving and 
maintaining dialogue boxes such as 
colour selectors and save boxes. 


THE PACKAGE 

Opening the box reveals 3 discs, a 500 
page reference manual, four reference 
cards and a 16 page release note. The 
reference cards detail the contents of the 3 
discs, the directory structure used by the 
compiler, the structure of the RISC OS 
library, and the command syntax for the 
compiler, linker and the other utilities in 
the package. 


The manual is not an introductory 
text; it assumes that you are already 
familiar with C. If you are not, then a 
good text is ‘The C Programming 
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Language (Second Edition)’ by Brian 
Kernighan and Dennis Ritchie; this is 
generally regarded as the C Bible, but you 
must get the second edition which deals 
with the ANSI C standard. 


Acorn’s manual is split into four parts. 
Part one details how to use the C compiler 
and the other software development tools 
in the package. Part two describes any 
differences between this version of the 
language and those on other machines. 


Part three describes how to develop 
RISC OS Desktop applications. As you 
read through this chapter it soon 
becomes clear that this package was 
used for writing Edit, Paint and Draw. It 
details the RISC OS library (although 
you will still need to refer to the 
commented header files on disc 3). 
Rather than having to keep calling 
Wimp_Poll and working out which 
window the event relates to, you can set 
up a handler function for a window (or 
the icon bar icon), which will be called 
automatically whenever an event occurs 
which relates to that window. This 
section also describes the writing of 
relocatable modules, the use of overlays 
and the interfacing of machine code 
routines to your program. Finally, part 
four contains the Appendices. 


THE SOFTWARE 

Disc 1 contains the compiler, linker 
and development tools. These are the 
symbolic debugger, which can be used to 
set breakpoints, examine and change 
variables and single step through 
programs; the Make utility, which 
makes it easier to split a large program 
into segments which can then be edited 
and compiled individually; the module 
header generator, which enables you to 
write relocatable modules in C; 
Squeeze, which compresses programs so 
that they automatically decompress 
themselves when run and two programs 
for converting between different 
dialects of C. 


Also on disc 1 are the shared C library 
and floating point emulator, the header 
files for the RISC OS library, object code 
and header files for the C library, and a 
large number of example programs 
demonstrating Wimp programming, 
writing modules, using overlays, and 
using the symbolic debugger, as well as 
the Dhrystone benchmarks. 


Disc 2 contains various libraries, 
including the C and RISC OS libraries, as 
well as a set of useful templates and 
another copy of the linker. Disc 3 contains 
a copy of the Wimp Template Editor, the 
commented header files for the RISC OS 
and C libraries (these are very useful), 
and some example programs 
demonstrating the use of overlays. In 
addition all three discs contain programs 
for installing the compiler on a hard disc 
or network. 


USING THE PACKAGE 

As the object code for the RISC OS 
library is on disc 2, the manual advises 
copying the compiled code onto disc 2 for 
linking. However, if you move all of the 
examples off disc 1, there is enough room 
to copy the RISC OS library onto it, which 
makes things somewhat easier. The 
compiler is invoked from the command 
line. Given that a number of options and 
file names are required, you may find it 
easier to store the commands to compile 
and link a program in an Obey file; 
however, a Wimp front-end would be 
extremely useful here (see the !Compile 
application elsewhere in this issue), 


As far as memory requirements go, if 
you are using the compiler on a 1Mbyte 
machine, then certain precautions will 
have to be taken to ensure enough space is 


‘available. If you are planning any serious 


software development, then you will find 
more memory and a hard disc very useful. 


DO I NEED IT? 
If you have not. yet taken the plunge, 
then programming in C is well worth 
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investigating if you intend any major 
software development. If you are planning 
on writing any serious Wimp applications, 
then this package offers greater control 
and flexibility than Basic. Most 
professional software written for the 


Archimedes in future will probably be Emerald Publishing 


written using this package. 





If you already have release 1 or 2, 
then you can upgrade to release 3 at 
moderate cost. This is definitely 
worthwhile, and all those who intend to 
develop any major software in C should 
consider this an essential step, as you 
will gain not only the new libraries, but 
also the ability to write relocatable 
modules and interrupt handlers. 
Additionally, earlier releases of C are no 
longer being supported by Acorn. 


Registered C users should receive full 
details on upgrades direct from Acorn. 
Upgrades are dealt with by Vector Services 


Ltd., 13 Dennington Road, Northants, An advanced user guide 
NN8 2RL. Your original discs should be by 
returned, but note that there is also a Anne Rooney 


charge of £5.20 for p&p in addition to the 
upgrade price itself. 





As an illustration, this month’s magazine The advanced user guide helps you get the 
disc contains an example of a C program, most from Acorn DTP. With full operating 
both in its source code format, and as an instructions, hints and tips, style guidelines, 


instructions on creating a wide variety of 
documents, and on how to exploit its 
powerful features to the full, this book leads 


executable machine code file. The source 
code can be examined by loading it into 
Edit. The machine code version, which you through ownership of Acorn DTP from 
implements windows, can be run from the installation to becoming an expert user. It 
Desktop as usual by double clicking on its goes far beyond the official User Guide. 
icon. 





Available now from Emerald Publishing, 
Dept R, PO Box 324, Cambridge CB1 3HB. 


Product ANSI C (Release 3) £14.95; examples disk, £3.95, p&p included, 
Supplier Acorn Computers Ltd Cheques payable to Emerald Publishing. 
Fulbourn Road, 
Cherry Hinton, 








Cambridge CB1 4JN. 
Tel. (0223) 245200 
Price £171.35 inc. VAT 
Upgrade from release 1 £70 inc. VAT. Upgrade 
from release 2 £50 Inc. VAT. 
RU 








RISC User December 1989 43 


PRODUCT NEWS FOR 
A USERS! 


SCSI CARD AND DRIVE 


Everything you need to upgrade your 
A3000 or Archimedes. 
Interface card £14900+VAT Hard Drive Kits £97500+vaT 


from from 


PRESENTER II 
RISC OS based 
graphics package (graphics, 


charts etc...) for education 


and business, 
£30, 95-VaT 


COLOUR CONVERTER 


Software and hardware card for capturing 
full colour images using the monochrome 
Watford Digitiser and colour video equipment. 


EF = £46995*vAT 


= 


Pes NS soe NS Use 


P-R O F. EnS S “LO NA 


wt 
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PRESENTER STORY 


A series based presentation software 
that allows you to make slides and 
o.h.p.'s obsolete. £199 95+VAT 


XY / 


COLOUR DIGITISER 


Single card real-time full colour 
digitiser for Archimedes 


mama Education discounts and site licences for software are available A 


t SALES HOTLINE 
a / 098 685 477 


Wood Farm, Linstead Magna, Halesworth, Suffolk IP19 ODU 





Please send me more information about: SCSI O Presenter IIO Colour Converter O 


Presenter Story O Colour Digitiser O 


Name Address 








Tel No. 





LINGENUITY, Wood Farm, Linstead Magna, Halesworth, Suffolk IP19 ODU 


Tel: 098 685 477 





ee month I thought we might turn 
our attention to an aspect of the 
Archimedes which we have covered less 
frequently than most in RISC User, and 
that is the sound system. It is not my 
intention here to show you how to produce 
stunning stereo sound from your machine, 
but to look at the basics of the sound 
system in a way which I hope is 
understandable, and will at least enable 
you to produce and modify some sounds of 
your own. 


Of course, if you want to dabble in 
musical composition, the Maestro 
application on Applications Disc 2 is an 
excellent piece of software, and well worth 
exploring, but it doesn’t help much with 
the fundamentals. There is one further 
point before we really get started: sound 
on the Are can often seem weak and 
disappointing. Well, Acorn has just used 
two very small speakers, even if it is 
stereo sound. I strongly recommend, if you 
have them to hand, plugging in some 
earphones using the miniature stereo jack 
socket at the rear of your machine. Even 
better of course is to feed the stereo output 
through the amplifier of your hi-fi system. 
Then you can really begin to appreciate 
what can be achieved. 


GETTING STARTED 

The Archimedes contains a music 
synthesizer which allows as many as eight 
so-called instruments to be played 
simultaneously. However, unlike real 
instruments, those generated by the 
synthesizer are not fixed. Each 
instrument can be assigned a voice from 
those currently available. This determines 
the characteristics of the instrument. 


Unfortunately, Acorn has also chosen 
to make life confusing for everybody by 
being inconsistent in its use of 
terminology when referring to sound. As 
far as RISC OS is concerned, what is 
called a voice by Basic is referred to as a 
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Into the Arc - Understanding the sound system. 


by Mike Williams 


channel, while RISC OS uses voice to refer 
to a waveform. Now you might think this 
doesn’t matter, but when you use Basic 
sound commands, the terminology is that 
used by Basic, but star commands use 
that appropriate to RISC OS. This is all 
very confusing, so let’s see what we can do 
to clarify matters. 


First of all, there are nine resident 
voices, and you can see what these are by 
typing the command *Voices. This will 
result in a table looking like Figure 1 
(assuming you have just switched on), 


Name 
WaveSynth-Beep 
StringLib-Soft 
StringLib-Pluck 
StringLib-Steel 
StringLib-Hard 
Percussion-Soft 
Percussion-Medium 
Percussion-Snare 
Percussion-Noise 


1 
2 
3 
4 
5 
6 
7 
8 
9 


Figure 1. The nine default volces 


The names may seem bewildering at 
first but will be readily familiar to 
enthusiasts of synthesized music, and are 
largely descriptive of the sounds they 
represent. 


Each voice, in fact, may be referenced 
by either a number or a name. For 
example, Percussion-Snare is voice 
number 8 (in the current list of voices). It 
is perfectly feasible to create other voices 
for use on an Archimedes, but the 
processes involved are outside the scope of 
this series. However, you may sometimes 
be fortunate to come across other software 
which adds to the list of voices available 
(see later). 


Referring again to figure 1, you will see 
that there is a single figure ‘1’ to the far 
left of the first voice listed. This indicates 
that the specified voice, WaveSynth-Beep, 
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has been assigned to channel (or 
instrument) 1. This provides us with an 
easy and immediate way of listening to 
any of the voices. This is because VDU7 
(or Ctrl-G) is always linked to channel 1. 
Thus pressing Ctrl-G will produce a sound 
corresponding to whatever voice is 
currently assigned to that channel (by 
default voice 1). 


There are two ways of assigning a 
voice to an instrument (or channel), the 
star command *ChannelVoice or the 
undocumented Basic keyword VOICE. 
However, they are not completely 
interchangeable. The star command 
follows the format: 

*ChannelVoice <n>,<voice> 
where <n> is the channel number, and 
<voice> is either the voice number, or the 
voice name. Thus both: 

*ChannelVoice 1 6 
and; *ChannelVoice 1 Percussion-Soft 
have precisely the same effect. However, if 
you choose to use the Basic keyword 
VOICE, the voice selected may only be 
specified as a Basic string i.e. as the name 
of the voice enclosed in quotes: 

VOICE 1,”Percussion-Soft” 
or as a string variable to which the voice 
name has been previously assigned. 


Try using any of these forms to change 
the voice assigned to channel 1, and then 
listen to the resulting sound by pressing 
Ctrl-G. You may be disappointed to find 
that the apparent differences are quite 
small, due again to the small speakers. 
However, the difference between a 
percussive voice and one of the string 
voices should still be quite obvious. You 
can also check on the assignment by using 
the *Voices command as before. 


You can also experiment quite easily 
with the stereo position of an instrument, 
again using channel 1 as the example, 
though the result will not be that obvious 
unless you use the stereo output socket 
and a set of headphones. 


Again there is a choice of using the 





command *Stereo. This time the 
parameters are identical in either case, 
the channel (or instrument) being 
controlled, and the stereo position. The 
latter is a number ranging from -127 
(meaning full left) up to +127 (full right). 
However, there are only seven discrete 
stereo positions for a channel, depending 
on the range: 


full left 
two thirds left 
one third left 


centre 

one third right 
two thirds right 
full right 


Thus: 

STEREO 1,-127 or: *Stereo 1,-127 
will both cause Ctrl-G to sound only on 
the left-hand speaker, and: 

STEREO 1,127 or: *Stereo 1,127 
will result in Ctrl-G sounding only from 
the right-hand speaker. 


CREATING SOUNDS 
So far we have seen how we can assign 

a voice to a channel or instrument, but the 
only instrument we have been able to play 
has been channel 1 which is always linked 
to Ctrl-G. To be able to play any of the 
instruments we need to master the use of 
the SOUND command. This has 
parameters as follows: 

SOUND channel, amp, pitch, duration, after 
There is also an exactly equivalent 
*SOUND command in RISC OS. 


There are eight possible channels or 
instruments which can be specified, and 
each will sound according to the voice 
assigned to it. The amplitude or volume 
should be given as a value in the range 
from 0 (silence) to -15 (maximum volume). 
The pitch of a sound indicates the 
frequency of the note to be sounded, but 
because of the nature of the normal 
musical scale, the range of possible values 
is a little complex. 


Basic keyword STEREO or the star 
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Details are given in the BBC Basic 
Guide, but for starters, middle C is 53 and 
the other notes on the scale, including 
sharps, run in steps of 4 up and down 
from this value (see Table 1). 





Table 1. The pitch values for notes in the 
octave containing middle C 


The fourth parameter determines the 
length of time for which the note is 
sounded, in the range 0 to 254 (255 gives a 
continuous note). Each increment in this 
value represents one twentieth of a 
second. Thus a value of 20 causes a note to 
sound for 1 second. The last parameter is 
entirely optional, but if included indicates 
the number of beats that should elapse 
before the note starts to sound. This can 
be useful for determining the position of a 
note within a bar, and for synchronising 
instruments, a topic which I hope to deal 
with in a future article in this series. 


Before we give any examples, we also 
need to know about the VOICES 
command. This Basic instruction limits 
the number of voices (instruments in 
effect) which can be active at any time 
(default 1). Keeping the number low 
improves performance. So set: 

VOICES 4 
which allows instruments 1 to 4. 


Now, as an example of the SOUND 
command: 

SOUND 1,-15,53,20 
will sound middle C (pitch 53), for 1 
second (duration 20 twentieths) at 
maximum volume (-15), using the voice 
currently assigned to channel 
(instrument) 1. By default this is 
WaveSynth-Beep. Now let’s be more 
adventurous: 

*ChannelVoice 2 Percussion-Snare 

SOUND 2,-15, 53,200 
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This assigns the specified voice as channel 
2, which is then sounded for 5 seconds. 
Why not try other sounds? 


MISCELLANEOUS INSTRUCTIONS 
Between them, RISC OS and Basic 
provide a number of other commands for 
controlling aspects of the sound system. To 
start with, SOUND ON and SOUND OFF 
can be used to turn the sound system 
completely off if required (and on again). 
The equivalent star commands are *Audio 
On and *Audio Off. The commands 
*Speaker On and *Speaker Off have a 
similar function in respect of the built-in 
speakers, but the output through the 
stereo jack socket is entirely unaffected. 


Apart from the amplitude specified by 
the SOUND command for individual 
instruments, the overall volume of the 
sound system can be controlled with the 
*Volume command. This requires a single 
parameter, a number in the range 1 (low 
volume) up to 127 (high volume). 


ADDITIONAL VOICES 

As the default voices supplied as part 
of RISC OS can become a little tedious, we 
have included a further selection of voices 
on the magazine disc for this issue. The 
new voices are supplied as a module called 
UserVoices, and these can be loaded 
simply by typing: 

*RMLoad UserVoices (or: *UserVoices) 
or simply double-click on its file icon in 
the RISC User directory viewer. The new 
voices can be displayed with the *VOICES 
command as explained earlier, and any of 
them assigned to an instrument just as 
with the resident defaults. 


Again, the simplest way of 
experimenting with any of these is to 
assign a voice to channel 1, and use Ctrl-G 
to sound it out. Some good effects can 
often be obtained by holding Ctrl-G down 
to allow the sound to be repeated rapidly. 
With a percussion sound, this comes over 
as rapid gun fire. Try the other voices to 
hear the effects that can be produced. AY 
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PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 

Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so you can workon many documentsat onceand instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 

Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 

Fora free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 

Major features include: 
* many documents loaded atonce œ automatic loading of VIEW, = [— — — — — -~— 














+ intuitive RISC OS user interface ViewSheet, Lotus, First Word | For a free brochure, complete and retum this coupon 

+ displaying and printing Plus, Tab and CSV files PipeDream 3 C View Professional C | 
of pictures within text * automatic saving of VIEW, Name | 

* built-in 93,003 word Lotus, Acorn DTP format, Tab | Address 
spelling checker and CSV files | 

e file compatibility with © multi-field sorting | 
PC & Z88 PipeDream and * use of all available fonts Post code | 
BBC View Professional * 62 spreadsheet functions © 

* background recalculation * external references for 3-D Colton Software, Broadway House,149-151 St, Neots| 

* keystroke compatibility modelling Road, Hardwick, Cambridge CB3 7QJ, England. | 
with Z88 & PC PipeDream * macro file recorder Fax: 0954 211607 Tel: 0954211472 

e Z88 filing system * slot protection EE TER a | 





All trademarks acknowledged. The chart in the screen shown above was produced by sending numbers from PipeDream 3 to Lingenwity’s Presenter 2 and then loading the resulting graph 
back into PipeDream 3. 


Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7QJ, England. 
Fax. 0954 211607 Tel. 0954 211472 








Acorn's Floating Point Unit 


David Spencer takes a look at Acorn’s long-awaited hardware co-processor unit 


for the Archimedes. 


T he hardware floating point unit (FPU) has 
been promised by Acorn right from the time 
that the Archimedes was launched. Now, over 
two years later, Acorn has finally released the 
FPU, but is it what people expected? Many 
people believed that Acorn would produce their 
own floating point chip that could interface 
directly to the ARM processor in the 
Archimedes. However, this is not the case. 
Instead, Acorn has opted to use an off-the-shelf 
floating point processor (the WE32206) and 
develop a custom chip under the name of the 
floating point protocol converter (FPPC) to 
‘glue’ it to the ARM. A consequence of this is 
that the FPU can only perform a subset of the 
floating point instructions set out by Acorn, 
with the remainder being implemented from 
these basic ones in software. For further 
details of the instruction set, see the article 
elsewhere in this issue. 


Unpacking the FPU is rather an anticlimax. 
The half-width podule contains just two chips 
and a handful of discrete components. The 
remainder of the package consists of an 8-page 
User Guide, various bits of metal work for the 
podule and a disc. This contains 
the software to drive the FPU 


$ A F Operation 
(replacing the floating point | Without FPU 
emulator), the old floating point | With FPU 
emulator for comparison, and a | Speed factor 
test program. 
Table 1. 
INSTALLATION 


Installing the FPU is little different to 
installing any other podule. There are 
however a couple of restrictions. Firstly, the 
FPU will not work at all with an A305 or 
A310, and secondly, the podule must be 
installed in slot two, which is the lower right 
one when looking from the front of the 
computer. Additionally, to fit the FPU to an 
old-style A440, the MEMC chip must be 
changed (to MEMC 1A) together with a few 
other modifications. This is provided free by 
Acorn to FPU purchasers, but must be dealer 
fitted. The User Guide explains how to update 
your /System directory to hold the new driver 
software, and how to use the test program to 
check that the FPU is working. 


IN USE 


The only noticeable effect of the FPU will be 
a speed increase in applications that use floating 
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point instructions. This will in general mean 
programs written in C, though not necessarily 
all of them, as a good programmer will avoid 
using floating point instructions if at all possible. 
RISC OS itself doesn’t use floating point, and 
will therefore be unchanged with regard to 
speed, as will any program written in Basic (as 
this uses its own floating point routines). 


Acorn claim a speed increase of up to eight 
times on floating point instructions when 
using the FPU. Table 1 gives timings for 
100000 iterations of various operations with 
and without the FPU, together with the speed 
increase, which averages out at about 9.4 
times. However, these are contrived examples, 
and in a practical program it is likely that 
floating point instructions will make up at 
most 10% of the whole program (unless it is 
very mathematical), and hence the speed 
increase will be watered down - perhaps to 
only a few percent. Obviously the effect will be 
different for each program, For example, a 
spreadsheet will benefit more than, say, a 
drawing program that only uses floating point 
instructions very occasionally. 


DVF SQT LGN SIN ATN 
9.67 26.04 59.09 


78.61 63.84 
1.04 1.55 13.8 11.21 8.33 
9.3 16.8 4.3 7.0 Ot 


Timing for various double precision operations 


(in seconds) 


CONCLUSION 

Are you willing to pay over £650 for a very 
limited speed increase? I’m not! Moreover, you 
don’t even get the advantage of avoiding having 
to load a module to use the FP instructions, It is 
my guess that Acorn expect the FPU to be used 
mainly in the R140 UNIX machine, as the 
widespread use of C throughout UNIX means 
that the speed improvments will appear 
substantially better. However, I can’t see many 
Archimedes owners rushing to part with their 
hard-earned money - those needing extra speed 
will probably opt for an ARM 3 upgrade. 


Product: Acorn Floating Point Unit 

Supplier: Acorn Computers Ltd., 
Fulbourn Road, Cherry Hinton, 
Cambridge CB1 4JN. 
Tel. (0223) 245200 

Price £688.85 (inc. VAT) 


£656.05 to RISC User members RU 
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Ace Computing 


RISC OS 
EUCLID 


The only multi-tasking 3D graphics package for 
the Acorn Archimedes 


Completely rewritten for Acorn's new operating system, RISC OS 
Euclid is a fully interactive, multi-document 3D graphics and 
animation system. Designed to be simple for the beginner to get 
to grips with, it has an intuitive, icon driven, single window 
interface. Its features include: 

Object orientated data structure 

Curved surface primitives 

+ Cameras and lights 

Grid locking and measurement facilities 

+ Import and Export to Draw 


*...ideal for use at home and in schools, colleges and 
industry...inexpensive, graphic, colourful and limited only by 
imagination” — A&B Computing, Oct '89 


EUCLID - Explore a new dimension! Price: £70 


Also available — RISC OS Mogul (animation add-on) £20 
(all prices include VAT, P&P) 


Send cheques to: Ace Computing, 
27 Victoria Road, Cambridge 


CB4 3BW. Tel: (0223) 322559. Bunndwog a0 
Or from your local dealer. = y 





Mastering the Wimp 
Part 4 - The Wimp Poll 


by Lee Calcraft 


I, the saga so far, we have looked at the 
process of initialising the Wimp, and of 
creating a window. But this does not put 
the window on the screen, it merely 
informs the Wimp about the proposed 
window. As yet it lies dormant. 


If we want our window to appear on 
screen, we must call SYS 
“Wimp_OpenWindow” (SYS &400C5) to 
inform the Wimp that the window should 
be opened. The Wimp will then initiate 
the process during the next few 
Wimp_Poll cycles - of which more later. 


In the program from part 1 of this 
series, lines 260-280 dealt with opening 
the task’s sole window: 

260 block’! 0=whandlet 

270 SYS "Wimp GetWindowState", , block% 

280 SYS "Wimp OpenWindow", , block’ 
The first line inserts the window handle 
(obtained from the earlier call to 
Wimp_CreateWindow) into the top of the 
block of RAM used to pass parameters. 
The second line calls 
Wimp_GetWindowState (SYS &400CB). 
This call reads back information about the 
window, and stores it in a form suitable 
for Wimp_OpenWindow, and thus avoids 
us having to set up the block item by item. 
Figure 1 gives the structure of this block, 
though we will not need to refer to it 
specifically. 


Window handle 

Visible Area min x co-ordinate 
Visible Area min y co-ordinate 
Visible Area max x co-ordinate 


Visible Area max y co-ordinate 

Scroll x offset rel to Work Area origin 

Scroll y offset rel to Work Area origin 

Handle of window in front of this one (or -1 if none) 
Window flags 





Figure 1. Parameter block returned by 
Wimp_GetWindowState, or supplied with 
Wimp_OpenWindow 





We only need to perform this 
subterfuge once at the start of the 
program. Future calls to 
Wimp_OpenWindow will be made in 
response to 
reason codes 
returned by 
the Wimp 
during 
Wimp_Poll, 
and in this 
case, the 
Wimp sets 
up the para- 
meter block 
for us - again 
see later. 


Using the debugging ald to 
reveal Wimp_Poll reason 
codes 


THE WIMP POLL ROUTINE 
The Wimp_Poll loop is central to the 
operation of any Wimp task, and is the 
means by which the task responds to 
external events, such as a click of the 
mouse. Lines 410-490 of the program in 
part 1 of the series deal with this vital 
operation, and are given here in listing 1. 


410 DEFPROCpoll 

420 SYS "Wimp Poll",,block% TO reason$ 
430 CASE reason? OF 

440 WHEN 1:PROCredraw 

440 WHEN 2:!block$=whandle$:Sys 


“Wimp_OpenWindow", , block’ 


460 WHEN 3:quit$=TRUE 

470 WHEN 17,18:IF block$!16=0 THEN 
quit$=TRUE 

480 ENDCASE 

490 ENDPROC 





Listing 1. The Wimp_Poll routine from the 
test program 


While any task is operative, a segment 
of code of this kind must be repeatedly 
called. In due course the Wimp will return 
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a so-called reason code to the task (a 
number currently in the range 0-19), and 
the CASE statement in the procedure 
listed responds to this in various ways. As 
soon as it has responded, the program 
calls Wimp_Poll again, and waits for a 
new reason code to come back. 


In the time between receiving the 
Wimp_Poll from our task, and returning 
a reason code to it, the Wimp will service 
each of the other active tasks in turn 
(subject to the range of reason codes that 
each task has requested it be informed 
of). In this way the Wimp performs so- 
called co-operative multi-tasking. It is 
called co-operative since it relies on each 
task being well-behaved, and not 
tarrying too long between receiving a 
reason code and re-polling the Wimp. In 
so-called pre-emptive multi-tasking, each 
task is allocated a strict time slice in 
rotation. 


REVEALING THE WIMP AT 
WORK 

By a simple trick, we can learn a great 
deal about the Wimp’s behaviour, and the 
way in which it returns information to a 
particular task. If you insert the following 
lines into the program from part 1 of the 
series, you will see what I mean: 

95 reason%=-1 

412 oldreason%=reason’ 

422 IF oldreason¢<>reason% THEN 

424 COLOUR 9:COLOUR 132:VDU4:0FF 

426 PRINT TAB(0,0)"Reason code=";reaso 





ney" 
428  VDU5:Z=INKEY (20) 
429 ENDIF 


If you now run the application, from the 
Desktop, you will see the current reason 
code for this task displayed at the top of 
the screen against the background of the 
Desktop. This is an exceptionally powerful 
debugging aid, and allows us to see 
exactly what is happening inside our 
Wimp_Poll loop. 


If you move the mouse around the 
screen, you will see the reason code 
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change, and you can look up the code in 
figure 2, which gives the full range:of 
codes known to Window Manager 2.00. 
For most of the time the code will be zero, 
indicating that nothing much is 
happening. This null reason code is 
ignored by many applications, but is acted 
upon if a task needs to perform 
background activities. The multi-tasking 
disc formatter published in RISC User 
Volume 2 Issue 8 formats a single track of 
the disc in response to reason code 0, for 
example. 







8 
a 
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Event 
Null_Reason_Code 
Redraw_Window_Request 
Open_Window_Request 
Close_Window_Request 
Pointer_Leaving_Window 
Pointer_Entering_Window 
Mouse_Click 
User_Drag_Box 
Key_pressed 
Menu_Selection 
Scroll_Request 
Lose_Caret 

Gain_Caret 

Reserved 

User_Message 
User_Message_Recorded 






Swomvanmson+0 


pa 


13-16 


oan 





Figure 2. Reason codes returned by 
Wimp_Poll 


When you move the pointer into the 
task window, the reason code changes to 5 
(pointer entering window). It then goes 
back to zero. If the pointer leaves the 
window, then reason code 4 is returned 
(pointer leaving window). If you click the 
mouse when the pointer is within the 
window, reason code 6 is returned. If you 
enter another window, or click the mouse 
when you are in another window etc., no 


, new reason codes will be displayed on the 


screen, since we are only monitoring those 
received by our task. 


When you drag the task window 
around, reason code 2 will be displayed (a 
window needs (re)opening). At the same 
time the Wimp returns a parameter block 
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giving the parameters of the window to be 
reopened. Our program code in the poll 
loop responds to this by calling 
Wimp_OpenWindow, and passing the 
parameters back to the Wimp. 


The Wimp then checks to see if it 
needs help from the task in redrawing the 
window at the new position. If the window 
drag results in no new part of the window 
being revealed, then the Wimp reopens 
the window on its own. If on the other 
hand the drag causes a previously 
obscured part of the window to be 
uncovered, and window flag 4 for the 
window is zero (meaning that the window 
contains text or graphics which the Wimp 
cannot generate without help from the 
application - see part 3 of this series), then 
the Wimp will next return reason code 1 
(redraw window request). Our task then 
responds to this by redrawing the window, 
but it needs to do this in a very special 
way, and we shall look at this in some 
detail next month. 


For the present, we will concentrate 
on simpler responses within the polling 
loop. If you click the mouse when the 
pointer is within our task window, a 
reason code of 6 is returned. If you take a 
look at the CASE statement which 
responds to the code, you will see that 
reason code 6 is ignored. We can easily 
make our task respond to mouse clicks by 
responding to this code. To find out what 
button has been pressed, we do not use 
the Basic MOUSE function, instead we 
examine the parameter block 
automatically returned by the Wimp with 
this (and other) reason codes. The 
structure of the block for reason code 6 is 
given in figure 3. 


Mouse x co-ordinate 
Mouse y co-ordinate 
Button type 


Window handle (or -1 for begnd or -2 for icon bar) 
icon handle (-1 for work area begnd) 


Figure 3. Mouse_Click parameter block 
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The mouse x and y co-ordinates (if we 
need them) are given as absolute screen 
co-ordinates rather than relative to the 
task window. The mouse button type is 
returned at block%!8, but exactly what 
appears here, and what actions cause 
reason code 6 to be returned depend on 
the settings of the work area flags for the 
window (see part 3 of the series). In our 
test program we set the work area flag to 
3: Click notifies task (once only). The task 
will therefore be informed each time that 
the mouse is clicked within the window, 
but with no auto-repeat action. 


You will see that the Wimp returns the 
window handle (at block%!12). This is 
vital if a task is using more than one 
window, since it will need to know which 
of its windows is involved with the event. 
If you insert the following lines of code 
into the test program, it will cause the 
task to issue a note each time a button is 
pressed over the task’s window, the exact 
pitch will depend on which button you 
press: 

465 WHEN 6:PROCmouse 

491: 

492 DEFPROCmouse 

493 CASE block%!8 OF 

494 WHEN 4:SOUND 1,-15,70,4, 
495 WHEN 2:SOUND 1,-15,100,4 
496 WHEN 1:SOUND 1,-15,140,4 
497 ENDCASE 

498 ENDPROC 


MASKING EVENTS 

We have seen that the circumstances 
under which reason code 6 is returned 
depend on the work area flags for the 
corresponding window, but there is 
another factor which determines exactly 
which reason codes are returned by the 
Wimp to each task. The Wimp_Poll call 
supplies a mask to the Wimp indicating 
which reason codes it wishes to be 
informed of. If we set this mask to zero (as 
we have done in our test program) then all 
codes will be returned. This is necessary 
in our test program because of its very 
nature, but it is good practice to mask out 
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the reason codes that your task does not 
want. This can speed up the 
responsiveness of the Wimp considerably - 
especially if you can mask out reason code 
zero, which will be returned very 
frequently in most cases. 


Supplying the mask is easy; it is the 
RO parameter in SYS “Wimp_Poll”. To 
mask out reason codes 0, 4 and 5 in our 
test program, we just need to alter line 
420 as follows: 


420 SYS "Wimp Poll", 1+(1<<4)+(1<<5),bl 
ock% TO reason% 
If you now run the program, you will see 
that reason codes 0, 4 and 5 no longer 
appear in the debugging display at the top 
of the screen. As you may have guessed, 
the masking bit number corresponds 
exactly to the reason code number (bit 4 
for reason code 4, etc.). The only proviso is 


that reason codes 2, 3, 7, 9, 10, and 13-16 
cannot be masked, and their mask bits 
(together with bits 20-31) must be set to 
zero. Furthermore, three reason codes (1, 
6 and 8) should not normally be masked, 
because the corresponding event will be 
queued until it is dealt with, and the 
Wimp will come to a halt in the mean 
time. The only reason for masking these 
events is to temporarily defer responding 
to them. 


Next month we will look at the process of 
putting text and graphics into a task 
window. In the mean time, you may like to 
experiment with Wimp_Poll reason codes. 
For further details, see the Programmer’s 
Reference Manual part III, pages 1192- 
1203. The experimental reason-code 
reporting task is included on this month’s 
magazine disc. 
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Address Book 
Diary 

Forms 

Data Base 
Labels 


|The Forms Manager 


School Registers 
Assessment Sheets 
Invoices 

etc 


"Fancy Labeller 





CAMDEN 
| SCHOOL | 
| LIBRARY | 





Bookplates 

Spice Jars 

Disc Labels 
etc 





Combine Fancy Fonts and Fancy 
Frames to make stylish labels. Frame 
and Font Designers included. 
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MEWsoft @ 


The Fax*File Manager 





With this easy to use program you can design 
forms from personal organiser up to A4 size, 
vertical and sideways, including lines, boxes, 
grids, large fonts, insertion of ASCII data etc. 
Ideal for Schools, small businesses and the 
home user. 





"All three packages will provide a lot of fun 
as well as doing a useful job." RISC USER 






For software that is 


Friendly and 
Easy to use. 










Combine the power of your ARC with 
the convenience and flexibility of a 
personal organiser to create a 
personalised data base. Comes with 
sample pack of prepunched paper. 



























All Packages £27.90 each. inc p.p 


11 Cressy Road 
Hampstead 
London NW3 2NB 
(Tel: 267 2642) 
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A Desktop Front-End for Compilers 


Chris Dollin describes an application which allows source code in C or Pascal to 
be compiled and linked within the Desktop environment. 


Due to lack of space, this program is 
supplied only on the magazine disc. 


The RISC OS Desktop provides a 
useful framework for many activities, but 
does not assist those involved in compiling 
and linking programs written in 
languages like C and Pascal. 


The !Compile application (supplied on 
this month’s magazine disc) overcomes 
such limitations. Installing the 
application “!Compile” adds another icon 
(a sewing machine - for stitching code 
together) to the icon bar. Dragging files 
from a directory onto this icon will result 
in them being compiled and linked. 


Rather than building in a variety of 
compilation commands, !Compile uses a 
simple technique for deciding what 
compilation means for any given file: the 
name of the directory within which the file 
resides is used to construct a command 
called 

comp DIRECTORY 
where DIRECTORY is the “short” name of 
the directory, i.e. not the full pathname. 
With suitable aliases set up, this is 
appropriate for Acorn’s Pascal and C 
compilations, as C files live in a 
directory called ‘c’, and Pascal files 
live in a directory called ‘pas’: 

*SET Alias$Comp_c cc %0 

*SET Alias$Comp_pas pascal %0 






ec -c -I$.RISC_OSLib %0 
if sys$returnCode = 0 then echo *** Linking *** 
if sys$returnCode = 0 then link -o !RunImage 0.%0 
$.CLib.o.Stubs $.RISC_OSLib.o.RISC_OSLib 


will usually not be Wimp tasks, you will 
be unable to carry out any other 
operations while they execute. 


The disadvantage of this approach is 
that it fails to cater for all the various 
possibilities which may be involved in 
compiling and linking. Options can be 
included in the SET Alias command 
together with the %0 (which is replaced by 
the file name), but this allows only one 
command to be executed. An alternative 
to the aliases given above, which 
overcomes this problem, is to create Obey 
files with the same names (e.g. comp_c 
and comp_pas). The Obey file can then be 
created so that it contains all the 
commands and options which you are 
going to need). Obey files can also be 
readily edited to suit changing needs. The 
best place for such an Obey file is 
probably within the directory containing 
the ‘c’ or ‘pas’ directory, 


For example, the following three-line 
Obey file will compile a program, and if 
that is successful link it with the libraries 
specified (including the display of a 
message that this latter stage is being 
performed): 












Any output generated by the command 
will automatically be put into a window by 
the Wimp. Of course, since the commands 


DESKTOP DIARY (Volume 2 Issue 10) 
Part 2 of the Desktop Diary as printed in 
the magazine suffered from a number of 
printing errors. Firstly lines 4270 and 
4280 were merged into: 

4270LDR R1,next STR RO, [R1] 
This should have been: 

4270LDR R1,next:STR RO, [R1] 
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More detailed information is supplied 
as part of the !Compile application on the 


magazine disc as a !ReadMe file. 


RU 


POINTS ARISING +» POINTS ARISING • POINTS ARISING « 


Secondly, some characters were missing 
from the ends of lines 2600-2620. These 
lines should be: 

2600IF !A%<>E% AND !next<!max CALLinser 
t_entry: !A%=E% 

2610IF !A%<>E% AND !next=!max err%=TRUE 
26201F !A%=E% SYS “OS _GBPB”,4,H%,A%+4, 164 


RU 
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More Archimedes Shareware Discs!! 








Here is a selection from our range of public domain program discs. Send an S.A.E. for a full list. 








Shareware 2: DFS reader, backup and archiver, 9 graphics 
demos, 256 colour Sprite Editor, CMOS ram Editor, Disc 
Copier, LQ printer Font Definer, Matrix Functions, BASIC Fast 
Screenload, Connect Four, Mastermind, Solitaire and Star Trek. 
Shareware 5: Fifty-one pieces of music for Maestro. 
Shareware 7: A disc database of Archive magazine plus data 
files for Archive, Risc User and Beebug. 

Shareware 10: Address book database, 4096 colour selector, 
expenses manager, Reversi game, Star Trek, a simple 3D 
volume of rotation program and 29 astronomical programs. 
Shareware 11: Six concerti in Maestro form. 

Shareware 12: Descent to Xeer, Rubik’s cube, BASIC 
compressor, Sinclair QL disc reader, Central heating calcs, 
Making cassette inlays, Floppy drive speed test, Address book. 
Shareware 13: Hard disc backup, Rubik’s clock, Interrupt 
module, Dustbin, Outline processor, Mandelbrots, Video 
database, Calendar, Golf. 

Shareware 14: ‘Arctist Plus’ — 256 colour art package. 
Shareware 15: 14 graphics demos, 2 !Draw fonts, 6 !Maestro 
tunes, 20 Sampled sounds. 


Shareware 16: (another) 256-colour art package, link to Psion 
organiser, YAIG-2 game (works in the overscan mode). 
Shareware 17: Acorn’s RISC-OS extras disc: new printer 
drivers; new version of !65Host; improved NetFS, NetPrint, 
NetFiler and NetStatus; IRQ latency fix; new hourglass and 
sound modules; WimpUtils module; new Clib (3.50), Colours 
(0.52) and FPEriulator (2.80). 

Careware 1: Calendar, Label Printer, “Make” utility, Othello, 
Sliding block puzzles, Simon, various small demos & games. 
Careware 2: Asteroids, Backgammon, Fractal curves, Desktop 
Calendar, ARM disassembler, Disc editor (ADFS & MS- 
DOS), Icon for BASIC editor, BASIC program compressor. 
Careware 3: Breakout, Fruit machine, 3D O’s&X’s, Forth 
language, Hard Disc backup, Graphical file dump, ‘Examine’ 
for MS-DOS, and (another) Icon for BASIC editor. 
Careware 4: graphics animation by MalcolmBanthorpe, serial 
link to BBC micro, dustbin, !PCdir — converts files to and from 
MS-DOS, screen blanking routine, WP file conversion routines, 
function key strip printer, some more tunes for use with Maestro 
and some desktop demos. 





Shareware — £3.50 each, Careware — £7 each (N.B. ALL £7 goes to charity). 





Send cheques (sorry, no credit card facilities) to: 


Norwich Computer Services, 18 Mile End Road, Norwich, NR4 7QY. (0603-507057 / Fax 250095) 














ARCade 


A round-up of the latest games for the Arc and A3000 by Peter Rochford. 


M uch has happened on the Arc games 
front since the last edition of ARCade in 
RISC User Volume 2 Issue 8. The 
appearance of the A3000 and the fact that 
it is selling in volume, has encouraged yet 
more games releases for Acorn’s RISC 
machines and it looks like there are 
plenty more on their way, too. 


Minerva has several new releases 
out now. Ibix The Viking (£19.95) is an 
arcade adventure very reminiscent of 
their earlier release Hoverbod. You 
guide our hero, Ibix, round the 
various screens collecting treasure 
and avoiding the bewildering array of 
nasties in your quest to rescue the 
Princess. You are armed with a 
supply of daggers that you can hurl at 
anyone who gets in your way. Eight 
‘Easy’ and eight ‘Hard’ screens are 
supplied with the game. There are 
plenty of puzzles to solve on each 
level, which become progressively 
harder as the game develops. 





Ibix the Viking 


The game features some nice graphics 
and an astonishing number of different 
sprites. Sound consists of a number of 
sampled snatches from pop songs which 
blast out at you at appropriate moments. 
There is also a cute little background tune 
that can be switched off if desired. 








When you have completed the supplied 
screens you can design your own with the 
game editor. This is really comprehensive, 
and allows you to design not only your 
own sprites, but how they are animated in 
the game. Ibix is a well presented and 
well thought out piece of fun software that 
should have wide appeal and provide 
lasting interest. To sum up - addictive! 


err rra tenes 


Casino 


Casino (£24.95) is another new release 
from Minerva by the. author of 
Thundermonk. It consists of a suite of 
gambling games which are multi- 
tasking,and includes a one-armed-bandit, 
blackjack, roulette and backgammon. 
Four people can play at once and game 
control is via the mouse. 


What can I say further about these 
games? We are all probably familiar with 
most of them, and they have been done so 
many times before on a wide range of 
different computers. The graphics in Casino 
are reasonable, but sorely disappointing 
when you consider what can be achieved on 
the Arc. Strangely enough, there is no sound 
at all. Ok, it is hard to justify sound with a 
game like blackjack, but what about the 
fruit machine! I won’t dwell further on this 
one as I consider I have seen better public 
domain games available free on bulletin 
boards. To sum up - a bit of a rip-off! 
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Yet another suite of golden oldies 
from Minerva is Family Favourites. Here 
we have versions of three well-worn 
computer games that have stood the test 
of time. Brain Drain (Pairs or 
Pelmanism) is where you are presented 
with rows of cards face down and have to 
turn them over and match the pairs 
before the computer does. Very addictive. 
Gridlock (Othello or Reversi) is the 
computer version of the ‘ancient Chinese 
game’, where you and the computer 
alternately place coloured discs on a 
board grid, trapping your opponent’s 
discs to convert them to the colour of 
your own. The winner, at the end of the 
game, is the player with the most discs. 


Ba 
f i 





Arcade Soccer 


Deadend (Gridrunner) is a game where 
you must guide a line on the screen, as it 
is being drawn, without letting it touch 
the edges of the screen or any obstacles, or 
even itself, and avoid another line being 
controlled by the computer. The object is 
to try to force the computer’s line into a 
small enough area so that eventually it 
will have to hit the edges or its own line 
(Is that clear?). 


On a lesser machine than the Arc, 
these games could be fairly ordinary and 
run-of-the-mill. However, the authors of 
Family Favourites have done a splendid 
job of utilising the Arc’s sound and 
graphics capabilities to produce a 
presentation that is slick and polished. 
This makes these games really enjoyable. 
To sum up - oldies but goodies. Buy it! 





Holed Out 


The 4th Dimension has already come 
up with some fine games for both the Beeb 
and the Arc. We reviewed their Holed Out 
golf game in a previous ARCade (Volume 2 
Issue 8). Now they have released two sets 
of extra courses for Holed Out. These are 
stand-alone versions, so you do not need 
the original game to be able to play them. 
They are priced at £16.95 each. Graphics 
and sound are the same as the original, 
but the games themselves feature much 
tougher courses. In addition to this, a 
Holed Out course designer has just been 
released enabling you to design your own 
courses. This is simple to use and you can 
create some really wicked layouts with it. 
To sum up - great additions to an excellent 
game. 


Again by The 4th Dimension and the 
same author as Holed Out, E-Type is a 
car race game. You take control of an E- 
Type Jaguar sports car and race along 
lanes and motorways avoiding such 
hazards as oil spills, rocks, policemen 
and roadworks. There are five tracks to 
choose from, which include deserts and 
snow scenes, along with a dash through 
a city by night. 


You race against other cars that do 
their best to force you off the road into a 
tree or river. Should you crash, you have 
several lives, and even when the wheels 
have fallen off, you are soon back in action 
and screeching off down the road after the 
opposition, Control of the car is by mouse, 
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and you can select auto or manual 
gearbox as well as mouse sensitivity 
and numerous skill levels. 


The graphics in E-Type are 
really superb, with a smooth 
scrolling screen and plenty of 
colourful detail in the scenery. The 
sound is all digitised and adds to the 
realism of the game, as well as being 
humorous too. There are so many 
nice features to this game, and it is 
all so well presented and thought 
out with great attention to detail. 
Crashing the car, for example, 
causes the young man and lady in it 
to be catapulted upwards out of their 
seats and then dropping back into the car 
again. The sharp eyed will notice that the 
young lady’s skirt flies up and ....... 





E-Type 


E-Type in my opinion is probably the 
best game yet for the Arc. I personally 
prefer it to Interdictor (reviewed in RISC 
User Volume 3 Issue 1). Fans of Out Run 
in the arcades will love it. The graphics go 
a long way in doing justice to the machine, 
and it is really fun to play. To add to the 
original game you can now buy a tracks 
designer too and this is straightforward to 
use, giving lasting interest to an already 
great game. To sum up - brings out the 
boy racer in you! 


Still with The 4th Dimension, several 
other games are due from this company 
before Christmas, but not available in time 





UIM 


for this review. These include UIM (Ultra 
Intelligent Machine), a kind of underwater 
Elite already out for the Beeb. The Arc 
version will feature much enhanced 
graphics and sound and cost £29.95. Also, 
there will be a 6 event sports simulation 
called The Olympics at £19.95. And Arcade 
Soccer (£19.95) which has been released 
for the Beeb will also be out in an 
enhanced version for the Arc. There are 
many subtle touches to this, such as 
choosing how the grass is cut, and the 
occasional appearance of a dog which runs 
onto the pitch! I’ll review all of these 
games when available in a future ARCade. 


For something different, Robico (well 
known for its adventure games on the 
BBC micro) has released Stranded for the 
Archimedes at £29.95, a completely 
rewritten and enhanced version of the 
game. 


Finally, rumour has it that some of the 
really big names in the world of computer 
games are working on software for the Arc, 
These include US Gold and Ocean I am 
told. If this is true, then we can hopefully 
expect some first class new releases in the 
future. I have heard that Out Run, 
Robocop and Batman are being worked on 
now. That’s all for this year. Happy 
Christmas to one and all. See you soon. 


Note: All prices quoted include VAT, and 
all the games may be obtained through 


BEEBUG - see current Retail Catalogue. 
RU 
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Single Stepper and Dustbin Updated 


by David Spencer 


ARM CODE SINGLE STEPPER 
Volume 2 Issue 9 Page 19 


There are a couple of bugs in this 
program which can cause the single stepper 
to alter the flow of execution of a program in 
an unpredictable manner. Both problems 
arise as a result of failing to allow for the 
fact that the program counter contains a 
value eight higher than the address of the 
instruction currently being executed. The 
first problem arises with data processing 
instructions of the form: 

ADD PC,PC, #4 
The program counter must be both the 
destination register of the operation, and one of 
the operands. Such instructions typically occur 
when using a jump table, such as that used by 
the SWI dispatcher code in most relocatable 
modules. The second problem is with 
instructions of the form: 

LDR PC, (PC, offset] or 

LDR PC, label 
Here, the program counter must be both the 
register that is loaded, and the base or offset 


register. Such instructions are very rare. Both 
problems can be cured by adding the 
following lines to the magazine listing. 

2975 ADDEQ R1,R1, #8 

2985 CMP R2,#15:ADDEQ R2,R2,#8 

2995 CMP R3,#15:ADDEQ R3,R3,#8 

3605 ADDEQ R1,R1,#8 

3625 ADDEQ R2,R2, #8 


Thanks to Philip Le Sueur for pointing out 
these bugs. 


THE RISC USER DESKTOP 
DUSTBIN 


Volume 2 Issue 6 Disc only 

There is a bug in this application which 
occasionally causes a ‘Subscript out of range’ 
error when trying to ‘bin’ a file. The cure for 
this is to change line 1550 to read: 

1550 FOR move=items TO uptl STEP -1 


This month’s magazine disc includes 
corrected versions of both the Single Stepper 
and the Tai ia Dustbin. AU 


THE BEEBUG A3000 DISC DRIVE 
BUFFER AND SCSI INTERFACE 


| A new product developed by Beebug which allows up to four external floppy disc drives and 
| seven hard disc drives to be attached. Just some of the features are: 


@ Connector for standard BBC-type 5.25" and 3.5" floppy disc drives. 
@ On board switches allow drive mapping to be changed. For example, the internal 
drive could be made drive 1, and an external drive as drive 0 - ideal for the PC 


emulator. 


@ Internal and external drives can be double stepped, allowing 40-track discs to be used. 
@ Hard disc drives and other peripherals designed to the Small Computer Systems 


Interface (SCSI) standard can be attached. 


@ On-board software allows full use of SCSI hard disc drives. 
@ Whole interface contained on an internal expansion card. 


As needs will vary, the interface is available with, or without, the SCSI option. In the latter case, | 
| the SCSI interface can be added by the user at a later date. 


The Beebug Disc Buffer and SCSI interface is in an advanced state of development. 
However, no price or release date can yet be given, and the specification is liable to change. 
For further details, and an information sheet, please write to : 

A3000 Buffer, Beebug, 117 Hatfield Road, St. Albans, Herts AL1 1EX, or ring (0727) 40303. 
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Squeezing Basic Programs 


by Barry Christie 


Ie] 
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For reasons of space this program is 
included only on the magazine disc. 


Even on the Archimedes, memory is not 
unlimited, and there are still times when it 
may be desirable to squeeze a program to its 
minimum size. That’s the purpose of the 
PSquash. When run, the program assembles 
a module called SqshModule, This can be 
loaded at any time by typing: 

*RMLOAD Sqshmodule 
from within Basic, or simply: 

*SqshModule 
in response to the star prompt. 


Once installed, a command of the form: 

*SQUASH <source> <object> 
will take a source file, squeezing it to 
produce the corresponding object file. The 
command will work with all Basic programs, 
including any ARM assembler embedded in 
such programs. The module will remove 
excess spaces, REM statements (including 
comments in assembler sections), and will 
reduce variable, function and procedure 


NEW RISC User BINDERS 


We now have in stock the new RISC User binders, 
specially designed to accommodate the larger size 
magazines of Volume 2 and Volume 3. 


£3.95+21 p&p 


SPECIAL OFFER 


RISC User Volume 1 sets with Binders 


* 


£12 + £3 p&p 


names to no more than two or three letters. 
The resulting program will be a lot less 
readable than the original, and you are 
therefore strongly recommended to make 
any subsequent editing changes only to the 
original source version of a program, re- 
squeezing when needed. 


There are some limitations or 
restrictions to the working of the module. 
All star commands in the source program 
must be given in the form of OSCLI 
statements (e.g. OSCLI(“LOAD FRED”) 
rather than *LOAD FRED). In ARM 
assembler, mnemonics must be in upper 
case only, while all variables (or identifiers) 
must start with a lower case letter in both 
basic and assembler. The exception to this is 
that function and procedure names may 
start with an upper case (or lower case) 
letter. The program uses screen memory to 
build up a table of variable, function and 
procedure names, allowing longer programs 
to be accommodated (and squashed). Ru 


Stock Code 2421B 





While stocks last you can purchase a complete RISC 
User Volume 1 set with a binder for just 


Stock Code 2419D 


(Note: the p&p price is for UK only. For overseas refer to our Retail catalogue) 
BEEBUG Ltd 117 Hatfield Road, St. Albans, Herts AL1 4JS. Tel. (0727) 40303 
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word processor. It can 

handle all aspects of the 
final printed result - the text, 
line graphics, photographs, 
company logos ete. Yet it can still be used to bash out 
a single page of text as well as any ‘simple’ word 
processor. It is a document processor. 


RISCOS 


Impression is one of the first products to take full 
advantage of the new multi-tasking WIMP based 
operating system for the Archimedes, so it is simple 
and intuitive to use - long gone are the days when users 
had to remember commands, or codes for each opera- 
tion, Only five main menu options control 
everything within Impression 


I mpression is more than a 


L 








The program is written in ARM assembler so it 
is very fast and very responsive. and uses the 
minimum possible RAM space. 





Frames 


Impression is a frame based page 
layout system. All objects on the 
page are held within frames which 
may be positioned freely anywhere 
on the page. Frames can contain text 
or graphics, they may overlap, and may be transparent 
or have any coloured background. They can have a 
variety of borders displayed around them and may be 
arranged in columns to create multi-columned text. 


Text frames may be linked to other text frames (even 
on subsequent pages) so text will automatically flow 
from frame to frame and page to page. Since Impres- 
sion has been designed primarily as a word processor, it 
is important that users can enter text unhindered. 
refore frames and pages are created automatically 
as text flows out of a frame, so that while text is being 











entered you do not have to 
worry about creating new 
frames or pages. 


Graphics frames may contain 
y sprite (for example images from Scan-Light) or any 
Draw file. All graphic frames may have the picture 
scaled within the frame to any degree, In addition the 
aspect ratio of pictures can be controlled and even 
locked to any required value. 








Windows 


Impression can handle up to 16 documents in memory 

at any one time, each being viewed in one or more 

windows. Each individual view may be scaled as 

required so that, for example, one view may be 

at 100% while another window shows the same 

document scaled to 20% so showing a live 

‘mini’ view or multiple page ‘thumb-nail’ 

views. This mechanism also allows two differ- 

ent parts of a document to be edited without 

the need to scroll between them. Impression 

can display its pages within the window as 

side-by-side left/right pages. and as 

vertically arranged pages in a more 

word processor-like fashion. There is 

no need to specifically turn over the 

page, thereby overcoming a limita- 
tion of traditional DTP systems. 
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Spelling checker 


Included with Impression is a 60,000 word spelling 
checker providing some of the most advanced spelling 
facilities. Check-as-you-type, user dictionaries, ignore 
dictionary, crossword and anagram solving and an 
intelligent ‘guess’ feature are included. Other related 
dictionaries control automatic abbreviation expansion 
as you type, and a hyphenation exception dictionary for 
precise hyphenation control over and above the normal 
automatic hyphenation. 








arranged 














Styles 


Like the most powerful word 
processors on the Mac, Impression 
stem of styles, Rather 
ing fixed text effects such 
as bold, underline etc, 
Impression allows 
the user to apply 
any user named 
style to any part 
of the text. This 
style may be 
defined and 
re-defined at 
any time to represent any combination of stylistic 
So for example one style, perhaps called 
ling’, may specify text to be in a Times font, one 
inch high, in italics and centered, This style may then be 
applied to any region of text with one key-press. 














Printing 


Included are the latest RISCOS printer drivers for Epson 
compatible 9 and 24 pin printers, and LaserJet compat- 
ible laser, ink-jet, and PostScript printers. These printer 
drivers ensure the output is to the maximum resolution 
the printer can manage. Impression also supports ‘text 
mode’ draft printing so text may be output as fast as 
possible using the printer's character set. The user 
therefore h choice between fast, text only printing or 
high quality text (any font, any size) and graphics 
printing. 








Impression comes with a ‘no quibble’ money back 
guarantee when purchased direct from Computer 
Concepts. 





This advert was designed. entered. laid out and edited on Impression 
AIl logos were created in Draw and imported into Impression frames. 
The pages were then ‘printed’ via the PostScript printer drivers te di 
This dise file was then sent directly to a Linotron photo-typese 
which output the final camera ready artwork. The studio pho 


were then pas 
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Other features: 


Master pages for consistent document design. 

+All measurements may be specified in inches, mm, em, 
points, picas, all to an accuracy of 1/72000ths inch, 
«Ideal for a [Mbyte machine - over 300K free memory! 
*Fast automatic disc spooling of documents larger than 
memory, allowing virtually unlimited document size. 
+Print multiple pages per sheet, any scale and rotated. 
«Includes Acorn's new outline font system and fonts. 
Fast graphic scale and PostScript graphics printing. 
«Automatic index generation. 

*The package includes a 200 page manual (produced 
entirely with Impression), with tutorial, introduction 
and reference sections. Four discs include Impression, 
the printer drivers, the outline font manager and fonts, 
example document, Line-art examples, utility programs 
ete. An independently produced guide book to 
typography and page design is also included, 


£149.00 +VAT (£171.35 inc) 








A more detailed brochure is available from: 


Computer Concepts Ltd 


Gaddesden Place, Hemel Hempstead, Herts HP2 6EX, (0442) 63933 


Hints & Tips... Hints & Tips 


Compiled by Lee Calcraft and Glynn Clements 
NON-MULTI-TASKING WINDOWS 


If you run a non-multi-tasking program from 
the Desktop which generates screen output, 
the Desktop will put up a window in which 
the output is displayed. If the program 
issues a mode change, the whole screen will 
be cleared, and output can be placed 
anywhere on the screen, just as if the 
program was running from outside the 
Desktop. In both cases, when the program 
terminates, the message “Press SPACE or 
click mouse to continue” appears, and once 
the user obeys, he is returned to the 
Desktop, exactly as it was before the 
program was invoked. During the period 
when the program was running, all tasks are 
temporarily halted. 


PRINTING OUT WITH VDU2 AND FX3 
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There are two ways to send text to a printer 
(apart from using a printer driver - see the 
article Printers, Drivers and Fonts elsewhere 
in this issue for further details). You can use 
VDU2 or FX3. In the first case, once VDU2 
has been issued, all text sent to the screen 
will also be sent to the printer, Thus: 

VDU2 

PRINT "Output" 

VDU3 

PRINT "Screen only" 
will send the word “Output” to both screen 
and printer. The VDU3 then turns the 
printer off, and the words “Screen only” are 
sent only to the screen. 


To send selected characters to the printer 

only, you can precede them with a 1. Thus 
VDU2,1, 65,1, 66,1, 67,3 

will send the string “ABC” to the printer 

only - since “A” is ASCII 65, “B” ASCII 66, 

and so on. 


If you are doing much of this, then 
*FX3,10 will make matters simpler. After 
issuing this FX call, all VDU output - 
including all text printed with “PRINT” will 
be sent to the printer at the parallel printer 
port only. It is cancelled with *FX3. Thus the 





following will send the words “Page one” to 
the printer, and execute a form feed, without 
affecting the screen. 

*FX 3,10 

PRINT "Page one" 

VDU 12 

*FX 3 


OS_SerialOp 


RISC OS provides a new set of OS_SerialOp 
calls. These can be used to set up data 
protocol, baud rates, send and receive serial 
data, and even to engage in XON/XOFF 
handshaking. See the new PRM page 189 for 
further details, 


RISC OS SERIAL FIX 


Note that the New RISC OS extensions 
(published on last month’s magazine disc) 
have some module fixes for certain parts of 
the RISC OS kernel. These include IRQUtils, 
which solves certain minor problems with 
the serial port. J 


DIY ERRORS RETURNING STRINGS 


The very useful error generating system 
built into the Arc can handle strings as part 
of its error message, as well as literals. This 
means that error messages created in this 
way can carry dynamic information - such as 
file names etc. For example: 

z%=OPENIN (file$) 

IF z%=0 THEN ERROR 254,"Screen fil 
e "+ file$+" not found" 


If the program’s Basic error handler uses the 
form: 

PRINT REPORT$ " at line ";ERL 
then a very full and useful message will be 
generated if the file is not found. 


PRE-EMPTIVE DESKTOP 


If you are running a well-behaved non-multi- 
tasking program from the Desktop, which 
has a competent error handler, you may be 
fooled when you hit certain types of error 
during file handling. If the filer can’t find the 
disc that it is looking for, then it simply 
issues a message for you to insert the correct 
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disc, The text will appear wherever the 
cursor happens to be when the attempted 
disc access takes place. The filer does not 
regard the presence of the wrong disc as a 
true “error” - more an oversight on the part 
of the user - and the message is not passed to 
the program’s error handler. 


The only simple way to deal with the 
situation is to leave the cursor somewhere 
sensible (with appropriate colours set) just in 
case the “error” occurs. 


ON ERROR LOCAL OFF 


The LOCAL error declaration implemented 
in Basic V is very flexible, and allows 
separate error handlers to be used in any 
given procedure, with automatic reversion to 
error handlers higher up the chain when the 
procedure ends. This facility can be used to 
temporarily switch off error handling within 
any given error handler in order to trap any 
errors within it, and then revert back to the 
current handler as soon as the error has 
been handled. Thus: 


ON ERROR PROCerror 


DEF PROCerror 

LOCAL ERROR 

ON ERROR LOCAL OFF 

PRINT REPORT$" at line ";ERL 
RESTORE ERROR 

ENDPROC 


CLEAN TERMINATION 


If you run a non Wimp program from the 
Desktop, you will get the following message 
when it terminates: ‘Press SPACE or click 
mouse to continue’. To avoid this add the 
line: 
SYS "Wimp _CommandWindow", -1 

to the end of the program, ensuring that no 
text-or graphics output can occur after this 
statement has been executed. A program 
which is then run from the Desktop will 
return you to the Desktop as soon as the 
program terminates. Note, however, that if 
such a program is run directly from a Basic 
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language environment, you will be left in a 
VDU5 state, and the program should execute 
VDU4 to return to normal cursor operation. 


SYSTEM VARIABLES AND Filer_OpenDir 
The command Filer_OpenDir requires a 
literal pathname, e.g. it will not accept: 
*Filer_OpenDir <Demo$Dir> 
To get round this, use an alias, e.g. 

*Set Alias$Temp Filer OpenDir <De 
mo$Dir> ‘ 

*Temp 
The variable Demo$Dir is replaced by its 
value when the Set command is executed, 
thus if Demo$Dir is adfs::Demo_Disc.Demo, 
then Alias$Temp is : 
Filer_OpenDir adfs::Demo_Disc.Demo which 
is the command that will be executed by 
*Temp. 


DON’T TRAP NULL REASON CODES 

Mike Ironmonger 
If your program does not perform any action 
on null reason codes, then bit 0 of the mask 
passed to SYS “Wimp_Poll” in RO should be 
set. This prevents null reason codes being 
returned to the application, which will result 
in all Wimp tasks running faster. 


INSTANT MANUAL 
John Oliivere 
For an instant, concise and information 
packed manual simply enable your printer 
and enter: 
*H, . 
and press return. 
If you are in the Desktop, press F12 first. 
RU 


Multitasking Link 
Archimedes - BBC 


List BBC files in a directory viewer Drag files to 
directories and applications. 


Software only £9 inc p&p 
Software + lead £20 inc p&p 


Ivoryash Ltd, 14 Perwell Close, Bredon, 
Tewkesbury Glos, GL20 7LJ. 








65 


RISC User Magazine Discs 


Our RISC User magazine discs include copies of all programs published in the corresponding 
magazine plus additional programs, demonstrations, screens and other bonus items. 
Some of these Bonus items are detailed below. 

Each RISC User disc with a complete set of programs costs just &4.75. 

To order your disc phone (0727) 40303 and ask for Telesales. 


Vol.3 No.1 - November 89 Magazine contents plus: 
RISC OS 2.0 Extras 
The latest versions of certain modules and applications - 
RISC OS bug fixes and enhancements, including new 
printer drivers for Epson and PostScript . 
A Module Information Utility 
Full information on all resident modules from the Desktop 
at the click of a button. 
Floating Point Assembler 
Assembler functions for Basic V to handle the ARM co- 
processor's floating point instruction set. 
Sample Screens 
From Computer Concepts’ Impression package. 
Noughts and Crosses Game 
A multi-tasking 3-dimensional noughts and crosses game, 





Vol.2 No.6 - May 89 Magazine contents plus: 
Pick-a-Palr 
A colourful version of the memory game Pelmanism in 
which you turn over cards and try and match pairs. 
Desktop Dustbin 
ARISC OS utility that allows files to be deleted simply by 
dragging them into a Dustbin. 
A Muiti-tasking Ray Tracing Display 
A display of a ray-traced letter ‘A’ using the ray tracing 
program published in April. 
Designer Intro 
Samples using this package from Techsoft. 
Render Bender Animation 
A sequence of ray-traced frames produced using Clares' 
Render Bender, reviewed in this issue. 


Vol.2 No.5 - April 89 Magazine contents plus: 
Dominoes 
A multi-tasking desktop dominoes game. 
Art Nouveau 


A sample screen created using this drawing package. 
Computer Concepts Scanner 
An image produced with the Scan-Light scanner, reviewed 
in this issue. 
The Molecule 
The version of the ray tracing program which draws the 
now famous molecule. 


Vol.2 No.10 - October 89 Magazine contents plus: 
Pipedream 3 Demo 
A full demonstration of the new Riscware PipeDream 3 
reviewed in this issue. 
Hot Keys 
ARISC OS application that allows keyboard alternatives 
to be used for common Desktop operations, such as 
opening a directory viewer. 


Vol.2 No.9 - September 89 Magazine contents plus: 
Sticky Desktop 
A handy RISC OS Desktop utility which allows files and 
directories to be dragged out of Directory Viewers, and 
stuck to the Desktop for use at any time. 
Digitised Screen 
A sample of the results that can be produced using the 
digitiser feature of the Brainsoft multi-IO podule. 
Atelier Screens 
Some sample screens produced using Atelier from 
Minerva, reviewed in this issue. 
Acorn DTP Screens 
Some examples of Acorn's new DTP package in use. 


Vol.2 No.7 - June 89 Magazine contents plus: 
Graphbox Examples 
Some sample graphs produced using Minerva's Graph 
Box package reviewed in this issue. 
Rasterbind 
A code breaker game with a difference - you can either 
solve the computer's puzzle, or let it solve yours. 
Sphere Circus 
Relax in front of this program which simulates spheres 
falling and colliding in a viscous medium. 
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Vol.2 No.4 - March 89 Magazine contents plus: 

Arc Utility 

A new version of BEEBUG's public domain file archiver 

and de-archiver. Documentation is included on the disc. 
Ray Chamber 

Ademonstration of the ray tracing capabilities of the 

Archimedes. 
A RISC OS Application 

A sample application, which illustrates the use of 

application directories and the multi-tasking WIMP calls, 


Postbag =e 


DONGLES DO NOT IMPRESS 


I saw an excellent demonstration of 
Computer Concept’s Impression at a recent 
show. However, the bad news is that CC 
intend to release it with some awful 
hardware ‘dongle’ to prevent unauthorised 
use. I once had the misfortune to purchase a 
program which relied on one of these dongles 
(I wasn’t aware of this at the time of 
purchase), but it caused nothing but trouble, 
the worst being that if something went 
wrong while running the program, the whole 
machine locked up, and had to be reset with 
the consequent loss of all data. 


As far as I am aware, there has never been a 
really successful hardware copy protection 
method, which didn’t cause problems for 
legitimate users. I don’t suppose Computer 
Concepts will be any more successful than 
other firms at solving this problem, 

Michael Lowe 


Some ten years ago, dongles were fashionable 
as a method of protection but in the computer 
world at large, appear to have largely fallen out 
of favour. One wonders why CC has decided 
to buck the trend. CC's current advertising 
apparently makes no mention of them. 


One can certainly envisage the potential 
confusion that might arise in any environment 
where multiple machines are in use, all 
needing to have the right copy of Impression 
matched up with the correct dongle. For the 
solo user there is less of a problem, apart from 
the inconvenience that might arise if the idea 
were to be adopted by many software 
producers. Other comment on this issue would 
be welcome. 


NEITHER DOES THE SOFTWARE 


It is disappointing that a machine the calibre 
of the Arc still has a very limited range of 
high quality software - unless, of course, you 
need an art package. I am still using 
Wordwise as a word processor, which despite 
its migration onto the Are, is still very quick 
and user friendly. I am looking forward to 
having a decent word processor as part of 
one of the new DTP packages. 


Another area sadly lacking in software is the 
database department. Like many others, I 
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use the excellent System delta plus, but the 
‘key’ disc system provides an extra irritation. 
Reporter fills some of the gaps in the System 
Delta printing department, but a lot of 
potential use is lost because only columns of 
data can be produced - no good for printing 
fancy addresses for example. 


And, of course, because of the key disc 
system, I now need three discs - the master, 
the working version including Reporter, and 
the data disc. To compensate for this feature, 
I am growing a third arm to shuffle discs! 
Roger Tipper 


It does seem to be true that many Archimedes 
owners are still using older word processors 
like Wordwise, View and Interword which have 
been transferred from earlier BBC micros. 1st 
Word Plus appears to be the most popular 
word processor specifically released for the 
Arc, with Pipedream also well favoured, but the 
continuing use of much older software must 
say something about later offerings (or does it 
reflect on the user?). 


Likewise, there is still little choice as far as 
database systems are concerned, and there 
would appear to be a good market still for any 
database package that is easy to use, is 
moderately powerful, but is above all flexible, 
and at a reasonable price of course 
(BEEBUG's Masterfile database, rewritten for 
the Archimedes, could well meet these 
needs). 


CALLING ARCHIE FANS 


Here in Switzerland there are not many 
Archimedes users, so I am very interested in 
getting in contact with Archie fans in 
England. I bought an A3000 with a 
multisync monitor, and now I am making my 
first steps with this superb machine. I am 
specially interested in graphics (animated) 
and simulations. I already own an Atari ST 
but it was too slow for me. I hope my new 
friend can do better. 


I am a student of computer science at the 
University of Zurich. If you are interested 
please contact me at Rufacherstrasse 84, 
4055 Basel, Switzerland. 

Alex Kupsky py 
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ROBICO ADVENTURES 


FOR THE ARCHIMEDES 








STRANDED! £29.95 


The brilliant new adventure from the leaders in Acorn 
adventuring! 




















It is the far distant future and the attractions of inter-galactic travel through the ever- 
expanding universe have tempted you into stowing away on board a large Starfreighter. 
The penalties, if caught, are severe ... but surely you have sufficient intelligence and 
resourcefulness to meet the challenge? 


Stranded! It is an enthralling science fiction adventure with over 220 locations, nearly 
100 objects and over 130K of text. It features several high resolution colour graphics 
screens, mouse driven input and an advanced parser. Buy it and you won't be 
disappointed! 


RISEIN CRIME £29.95 


Can you rid yourself of the shackles of a conformist, mind-imprisoned society? Mouse 
driven input, advanced parser, 396K of text, 400 locations, 150 objects and several high 
resolution graphics screens make this an adventure to remember! 








FUGITIVE'S QUEST £29.95 


You have been convicted of a murder you did not commit. Can you escape and prove 
your innocence? 230 locations, 80 objects, an advanced parser, mouse driven input 
and several full colour, photo-quality illustrations combine to create a must for 
adventurers! 











ENTHAR SEVEN £29.95 


Your interplanetary Space Hopper begins to decay. You have to land.safely and then 
explore the planet in order to regain the freedom of the stars. 450 locations, 80 objects, 
1200 messages, an advanced parser and some of the best graphics you will ever see 
make Enthar Seven a true mega-adventure! 





Robico Adventures are available from all good computer stores or direct from 
ROBICO, 3 FAIRLAND CLOSE, LLANTRISANT, MID GLAM CF7 8QH Tel. (0443) 227354 


Please make your cheque payable to 'Robico' 
or you may pay using your ACCESS card. 


Technical Queries 








Dear Sir, 

I am very ‘pleased with the RISC OS 
Desktop, it is great for handling disc 
operations and running applications, 
including of course Basic programs, but it 
is not very helpful if you want to examine 
or edit a file. Do know of any ways around 
the problem? 


Bill Sherwood 


The real omission on the Desktop is the ability 
to load a file by clicking on it in some way. If 
Double-click with Shift held down would 
perform a *LOAD, then the problem would be 
solved. We could set up LOAD aliases to load 
Basic files, or Obey files into a particular 
editor. Short of this I most often use the Disc 
Menu module which we published some time 
back (RISC User Volume 1 Issues 1, 2 and 3, 
with updates in Volume 2 Issues 1 and 2). 
Double-clicking on files from the disc menu 
with the Adjust rather than the Select button 
causes them to be loaded rather than Run. 


But there are other approaches. If you have a 
particular directory which holds files that you 
wish to examine or edit, you could make the 
directory into an application (by giving it a 
name beginning with “!”), and set up a !Run 
file to select that directory as the current 
directory when you double-click on it (as well 
as displaying its contents). The following will 
do the trick: 

DIR <Obey$Dir> 

SET Alias$temp Filer OpenDir <Obey$Dir> 

temp 
These 8 lines should form the !Run Obey file in 
your directory. 


When you double-click on your directory, a 
directory viewer will open on it, and at the 
same time it will become the current directory. 
This means that if you quit the Desktop (with 
Shift-Ctrl-F12), and can get into Basic, and 
load the required file by typing: 

LOAD <filename> 


RISC User December 1989 


Another approach is to use the Desktop Basic 
Handler published in RISC User Volume 2 
Issue 8. This is a RISC OS application which 
sits on the icon bar and allows you to drag a 
Basic file to it, which it immediately converts 
to a text file which can be dragged into Edit. 


Lee Calcraft 


Dear Sir, 

I have seen your article Anti-alias fonts in 
the 256 colour modes in the June issue of 
RISC User. The code works well, but | am 
having some difficulty in using it in modes 
18 and 19. 


Prof. Raffaele Giovanelli, Milano. 


The problem is that the anti-alias fonts behave 
differently in the 256 colour modes from all 
other modes. Mode 18 is a two colour mode, 
and mode 19 a four colour mode, so the 256 
colour approach will not work. 


In RISC User Volume 1 Issue 3, we ran an 
article on using these fonts in 16 colour modes, 
and the approach for modes 18 and 19 is very 
similar. The program segment below should 
get you started: 

MODE 19 

*SET Font$Prefix $,!Fonts (or $.Fonts) 

VDU 23, 25,2, 4,8, 121 

VDU 23,25, &80,1,0,0,0,&F0,&FO, &FO 

SYS "Font_FindFont",,"Trinity Medium", 1 
2*16,12*16 

SYS "Font_Paint",,"Text in Trinity", &10 
0,800 


With only two colours, mode 18 cannot be used 
to perform anti-aliasing, since there are no 
colours with which to create intermediate 
coloured pixels. But you can still put text on 
the screen. To do this, just alter the 3rd line 
above to: VDU 23,25,1,81 The “1” is the 
number of bits to use for anti-aliasing (in mode 
18 there is only one bit available). 


Lee Calcraft RU 
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RISC User is available only on subscription at the rates shown below. Full 
subscribers to RISC User may also take out a reduced rate subscription to 
BEEBUG (the magazine for the BBC micro and Master series). 


Subscription Rates RISC User RISC User All subscriptions, 


A BEEBUG | aidar ores 


UK, BFPO, Ch.Is £16.90 £25.00 sterling. We will 

Rest of Europe &Eire £24.00 £36.00 also accept payment 

Middle East £29.00 £43.00 by onnee E 

Americas & Africa £31.00 £46.00 ’ 

Elsewhere £34.00 £51.00 eI orden 
Back Issues 


We intend to maintain stocks of back issues. New subscribers can therefore 
obtain earlier copies to provide a complete set from Vol.1 Issue 1. Back issues 
cost £1.20 each. You should also include postage as shown: 


Post and Packing UK, BFPO, Ch.ls Europe plus Eire Elsewhere 
First Issue 60p £1.00 £2.00 
Each subsequent Issue 30p 50p £1.00 





The programs from each issue of RISC User, together with a number of additional 
items, are included on a monthly 3.5" disc. This will be available to order, or you 
may take out a subscription to ensure that the disc arrives at the same time as the 
magazine. 


Disc Subscription Rates UK Overseas Disc subscriptions 

include postage, but 

Single issue discs £ 4.75 £ 4.75 you should add the 

Six months subscription £25.50 £30.00 appropriate rate (see 

Twelve months subscription £50.00 £56.00 above) per dise for 
individual orders. 


RISC User & BEEBUG, 117 Hatfield Road, St Albans, Herts AL1 4JS. 


Tel. St Albans (0727) 40303 FAX. (0727) 60263 
(24hrs answerphone for Connect / Access / Visa orders and subscriptions) 





RISC OS 2.0 Extensions 
The new printer drivers for the 
Integrex Colour and HP Laserjet 
printers, to add to the extensions 
supplied last month. 


HighLow 
For some light relief an Archimedes 
version of this popular card game, for 
two players or user versus computer. 


ArcScan Data 
This month’s ArcScan data files. 
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Desktop Caiculator 
An alternative and much improved 
calculator which works in decimal, 
binary or hex. 


Readable 'ReadMe’s 
An application to make ReadMe files 
readable from the Desktop. 


Mastering the Wimp (Part 4) 
Wimp testbed with open window 
displaying WIMP_POLL events and 
responding to mouse clicks. 
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Acorn’s Release 3 of ANSI C 
Demonstration window program 
written in C, together with the 
compiled and runnable machine code 
version. 


RISC User Dustbin 
The latest version of this very useful 
Desktop application. 


Single Stepper Updated 
An improved version of the RISC User 
Single Stepper. 


Plus the following programs 
from RISC User magazine: 


Screen Compressor 
A module for the speedy and efficient 
compression and expansion of screen 
displays. 


Application Shell Generator 
Create application directories, Obey 
files and their sprites with ease using 
this simple-to-use program. 


Squeezing Basic Programs 
A module which will compress any 
Basic program (including ARM 


Into the Arc 
A module providing a further 7 voices 
for you to experiment with. 


A Desktop Compiler Front-End 
A Desktop application which greatly 
improves the convenience of compiling 
C and Pascal programs (and others). 


e 4 
: THE INDISPENSIBLE PACKAGE FOR ALL HARD DISC USERS 
Hard Disc Companion 


This package contains three comprehensive, 
easy to use utilities to backup your hard disc, 
create file archives, and search for files. 
All three utilities were written specifically 
for the RISC OS desktop environment, and 
are multi-tasking. 


. Hard Disc Backup 


The backup facility allows you to save the contents 
of your hard disc onto floppy discs. It is 
comprehensive, easy to use and very reliable. Two 
types of backup are possible; Full and Incremental. 
Full saves every file on the hard disc to floppy. 
Incremental saves only those files added or changed 
since the last backup. Certain files are automatically 
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compressed to reduce 
Spark - File Archiver 


the number of floppies 

needed for the backup. | Spark is an archiving program used to create and 
Restore is equally maintain file archives. It is entirely WIMP based, with 
comprehensive with the contents of an archive displayed in a similar way 
to an ADFS directory. Files may be dragged directly 


options for full, partial 
or file by file restore. from a directory into the archive, or vice versa. An 
















Individual files can be 
restored by dragging 
from the backup disc to 





An automatic reminder 
facility can be set up to 
remind you at regular 
intervals to perform a 
backup. 


Members price: 


£35.00 


Stock code: 0106C 


the required destination. 





important feature of Spark is that it automatically 


compresses the files being 
archived. Spark is very easy 
to use, and has many uses, For 
example, you could put 2MB 
(or more!) of sprites onto an 
800K floppy disc. Then, to 
load a sprite into ArcPaint, 
simply drag it from the archive 
- it will be decompressed 
automatically. Spark has 
many powerful features, and 
is compatible with the public 
domain archiver, Arc. ~ 





Econet Compatibility 
Although designed for hard disc users, this package is 
ideal for use with Econet. Site licences are available - 
please phone for details. 


















Find File 


Find File is a fast, easy-to-use utility for 
locating files on hard disc, floppy disc 
and Econet. Find File runs from the 
multi-tasking Desktop environment, so 
it can be left to search for a file while 
you do other things. As well as finding 
individual files, Find File can locate 
files that match a wildcarded search 
string, or that have a specified filetype. 
Once a file has been located, Find File 
can give full information about a file 





including its filetype, length, and 
pathname, In addition, you can open a 
directory viewer on the file so that it can 
be easily loaded, executed, deleted etc. 





